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PREFACE 



This book describes Systems Network Architecture (SNA) as it relates to 
sessions between logical units (LUs). LUs are the ports through which appli- 
cation programs> terminals, and terminal operators communicate across an SNA 
network. LU to LU sessions support communication between these end users. 

This book shows the structure of an LU and defines the characteristics of 
five types of LU to LU sessions. It also discusses the data streams that are 
valid for each type of LU to LU session. 

This book does not describe any specific equipment or programs that may 
implement SNA, nor does it describe any implementation subsets or deviations 
from the architecture. These matters, as well as information on product 
installation and system definition, are described in implementation litera- 
ture for the applicable products. 



Intended Audience 



This book is intended for systems programmers and others who need detailed 
information about SNA in order to develop or adapt a product or program to 
function within an SNA network. 

An understanding of SNA concepts is assumed throughout this book. The basic 
concepts can be obtained by reading SNA Concepts and Products. (See "Related 
Publications" below for an order number.) 



Intended System Level 



Systems Network Architecture is independent of product schedules and levels, 
Extensions and modifications to SNA will be described in future editions of 
this book, however, as SNA-based products are released. 



HOUI THIS BOOK IS ORGANIZED 



This book is organized into two parts and their supporting appendixes. Part 
1 describes the types of LU to LU sessions. Part 2 describes the elements of 
the data streams used by LU to LU sessions. 

Part 1 Chapter 1, "Introduction," describes the types of LU-LU sessions that 
are allowed and the structure of the LU. 

Part 1 Chapters 2 through 6 describe LU-LU sessions types 1, 2, 3, 4, and 6. 
The characteristics of these LU-LU sessions are discussed, and activation 
parameters associated with their BIND SESSION requests are given. 

Part 2 Chapter 1, "SNA Character String (SCS)," describes the control func- 
tions for SCS controls used by LU-LU session types 1 and 4. 

Part 2 Chapter 2, "SNA 3270 Data Stream," describes the data stream used by 
LU-LU sessions types 2 and 3. 

Part 2 Chapter 3, "Structured Fields," describes the structured fields used 
by LU-LU session type 1. Structured fields used by LU-LU session types 2 and 
3 are described in 3270 Data Stream Programmer's Reference. 

Part 2 Chapter 4, "Function Management Headers," describes the FM headers 
used by LU-LU session types and how they are used to select destinations and 
manage data. 

Part 2 Chapter 5, "Compression and Compaction," describes how data can be 
compressed or compacted using string control bytes (SCBs) on LU-LU session 
types 1 and 4. 
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RELATED PUBLICATIONS 



The following publications are related to this book. 

Systems Network Archi tecture: Concepts and Products* GC3Q-3072, introduces 
you to SNA. This book helps you develop a basic understanding of an SNA 
network. 

Systems Network Architecture: Technical Overview, GC30-3073 (when 
available), i ntroduces you to the functions performed by SNA products. 
Information is organized on a f uncti on-by-functi on basis rather than on a 
component-by-component basis. It does not describe SNA in the detail 
required for design or development of products. 

3270 Data Stream Programmer's Reference, GA23-0059. This book describes the 
SNA 3270 data stream, which is used by LU-LU session types 2 and 3. 

Systems Network Architecture: Reference Summary, GA27-3136, is a handbook 
that provides selected reference information. The handbook contains SNA 
formats and protocols that you need most frequently when using manuals on 
specific IBM SNA products. 

Systems Network Architecture, Format and Protocol Reference Manual: Archi- 
tecture Logic? SC30-3112, is a comprehensive reference book containing the 
formats and protocols of SNA from a design viewpoint. 

IBM Cryptographic Subsystem Concepts and Facilities, GC22-9063. This book 
describes the cryptographic facility used by SNA. 



SUMMARY OF AMENDMENTS 



Part 1 Chapter 1 - Introduction 

This chapter was rewritten to provide added detail on LU structure. 

Part 1 Chapter 2 - LU-LU Session Type 1 

LU-LU session type 1 now allows data streams that contain structured fields 
and the Set Attribute (X^S*) SNA character string control. These enhance- 
ments enable data streams to carry color, highlighting, and character set 
information on a type 1 session. 

Part 1 Chapter 3 - LU-LU Session Type 2 

LU-LU session type 2 now allows opt i ons with the SNA 3270 data stream that 
carry color, highlighting, and character set information. The data stream 
also allows for parti ti oning of the display screen, scrolling of i nformation 
within those parti ti ons, and validating of fields. 

Part 1 Chapter 4 - LU-LU Session Type 3 

LU-LU session type 3 now allows options with the SNA 3270 data stream that 
carry color, highlighting, and character set information. 

Part 1 Chapter 5 - LU-LU Session Type 4 

LU-LU session type 4 remains unchanged except for a few changes made for 
technical clarity. 

Part 1 Chapter 6 - LU-LU Session Type 6 
This is a new chapter with this edition. 
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Part 2 Chapter 1 - SNA Character String (SCS) 
Additional SCS controls have been added. 

Part 2 Chapter 2 - SNA 3270 Data Stream 

The SNA 3270 data stream now can carry color, highlighting, and character set 
information. The data stream also allows for partitioning of the display 
screen, scrolling of information within those partitions, and validating of 
f i elds. 

This chapter no longer contains the formats and protocols of the data stream. 
For information on formats and protocols, see 5270 Data Stream Programmer ' s 
Reference. 

Part 2 Chapter 5 - Structured Fields 

This is a new chapter with this edition. It contains structured fields used 
by LU-LU session type 1. For structured fields used by LU-LU session types 2 
and 3, see 3270 Data Stream Programmer's Reference. 

Part 2 Chapter 4 - Function Management Headers (FMHs) 
FM headers used on LU-LU session type 6 have been added. 

Part 2 Chapter 5 - String Control Bvtes (SCBs) 

This chapter remains unchanged except for a few changes made for technical 
clari ty. 
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PART 1 CHAPTER 1. INTRODUCTION 



This chapter briefly describes Systems Network Architecture (SNA) as it 
relates to the structure of logical units (LUs). It summarizes some of the 
information found in SNA Concepts and Products and introduces the structure 
of an LU. 

SNA networks provide two broad categories of services, as shown in Figure 
1-1. One category is the services of the path control network* which 
consists of the path control and data link control components shown in Figure 
1-1. These services fulfill the fundamental purpose of any network: to 
transmit data quickly and accurately between network locations, regardless of 
how distant they are from one another. Services of the path control network 
are described in SNA Concepts and Products. 

The other category is network addressable unit (NAU) services, which handle 
the information passed between end users across the path control network. 
This category also includes services that allow the network to coordinate its 
activities, such as resource allocation, through the network nodes. 



Logical Units (LUs) 



Physical Units (PUs) 



System Services 
Control Points (SSCPs) 



End User 
Servi ces 



Sessi on 
Network 
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Data Flow Control 
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Transmission Control 
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Data Flow Control 
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Transmission Control 
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Path Control Components 



Data Link Control Components 



Figure 1-1. Distribution of services with an SNA network. 

NAU services used in exchanging data between end users are referred to as 
end-user services. These are the principal services provided by logical 
units. NAU services that allow the network to coordinate its activities are 
called session network services. Each network addressable unit also contains 
data flow control services and transmission control services, which lie 
between the other NAU services and the path control network. Figure 1-1 
shows the services mentioned, and SNA Concepts and Products has introductory 
material on each service. 

Systems Network Architecture is structured so that system designers can build 
systems with interchangeable components and network users can share common 
function. One common function is the path control network. Each user has 
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access to the path control network through a logical unit tailored to the 
user. One user can talk to another user when one logical unit is "connected" 
to the other logical unit through the path control network. 

The session between two end users is called an LU-LU session. In order to 
discuss network functions conveniently, an LU-LU session has three major 
categories (Figure 1-2): 

• Application. A terminal operator, user application program, or device 
medium. This category is called the end user throughout this book. 

• Logical unit (LU). The LU handles the way data is presented to the end user 
and the flow of data into the path control network. 

• Path control network. The path control network coordinates the trans- 
mission of data over the telecommunications links. 



End user 
(application, terminal, 
or medium on a device) 



Logical unit 



Path control network 



Logical unit 



End user 
(application, terminal, 
or medium on a device) 



Figure 1-2. LU-LU session categories. The LU-LU session is divided into 
three categories: end user, logical unit (LU), and path control network. In 
some LU-LU sessions, the second end user is replaced by a service within the 
LU. 



Logical units are the ports (or addresses) through which users gain access 
the path control network. This chapter describes the structure of logical 
units and shows how they relate to the other components in the network. 



to 



Note: Logical units are one form of network addressable unit (NAU). The 
other NAUs, the physical unit and the system services control point, are 
introduced in SNA Concepts and Products and described in detail in SNA Format 
and Protocol Reference Manual: Architecture Logic. 
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SESSIONS 



One end user talks to another by establishing a session. A session is a 
temporary logical connection between NAUs or, in the only case covered in 
detail by this book> between logical units. An LU-to-LU (LU-LU) session is 
started when one LU, called the primary LU or BIND sender> sends a BIND 
SESSION request to another LU> called the secondary LU or BIND receiver. The 
BIND SESSION request (plus the ensuing responses) establishes this formally 
bound pairing of LUs. The BIND SESSION request also defines the capabilities 
of the session partners and the protocols they can use during the session. 

Each LU represents its session partner with a group of functions, called a 
half-sessi on. Two formally bound half-sessions make a session. 

The LU must establish a session with the system services control point (SSCP) 
if it wants to operate within the domain of that SSCP. This session is called 
the SSCP-LU session. The SSCP-LU session is not apparent to end users except 
when they require network services. (For detailed information on the SSCP-LU 
session, see SNA Format and Protocol Reference Manual: Architecture Logic.) 

The LU also establishes sessions with other LUs on behalf of its end users. 
Each implementation defines the maximum number of concurrent sessions that 
ar& allowed. For example, Figure 1-3 shows an LU in session with an SSCP and 
three LUs. 

The LU services manager controls the end user activities for each 
half-session activated by the LU. It is the LU component that is responsible 
for sending data to and receiving data from the end user. It is also respon- 
sible for activating sessions, managing the resources of the LU, and handling 
recovery and restart management. 



TYPES OF LU-LU SESSIONS 



SNA defines more functions than are needed or can be used by some end users, 
whether the end user is an application program, a terminal alone, or a termi- 
nal and operator. As a result, some LU functions are mandatory and others are 
opti onal . 

The options are selected by specifying a profile number and by establishing 
usage criteria in the BIND SESSION request that activates the session. By 
grouping these profiles to match the three components of the half-session, 
one obtains the LU-LU session types that are discussed in this book. Figure 
1-3 shows the components of the half-session and their related profiles, and 
Figure 1-4 shows how parameters of the BIND SESSION request are used to 
select options of those components. Figure 1-5 shows the valid profile 
numbers for each type of LU-LU session. The SNA Reference Summary lists each 
profile by profile number, identifies what SNA requests are valid in each 
profile, and highlights the protocols that each profile allows. 

This manual describes LU-LU session types 1, 2, 3, 4, and 6 at a level of 
detail that allows users of IBM products to understand the architecture 
underlying those products. LU-LU session type is not described outside of 
this chapter. Type implementations may use any format or protocol defined 
by SNA, and may supplement SNA formats and protocols with 
implementation-defined formats and protocols. They may not replace SNA 
formats and protocols with implementation-defined formats and protocols. 
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Logical Unit (LU) 



LU Services Manager (LU.SVCJ1GR) 
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PS profile 
< — - and usage 



FM profile 
and usage 



TS profile 
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Path Control Network 



V V V 
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Figure 1-3. Example of LU_LU and LU-SSCP sessions. An LU comprises an LU 
services manager and one or more half-sessions. It handles the way data is 
presented to the end user. A half-session comprises either session network 
services (SNS) or session presentation services (SPS)> plus data flow control 
(DFC) and transmission control (TC). Each half-session is connected through 
the path control network to another half-session, either in the system 
services control point (SSCP) or in another logical unit. 
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Figure 1-4. Use of BIND SESSION request parameters. Each LU has three 
half-session components that support the end user. The profile and usage 
parameters of the BIND SESSION request are used to define the half-session 
functions desired. 
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Figure 1-5. LU-LU session types. The allowable subsets that can be speci- 
fied with the TS (transmission services), FM (function management), and PS 
(presentation services) profiles are shown. 
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STRUCTURE OF AN LU 

An LU is composed of components that provide services to the end user as well 
as components that interact with the path control network. The components 
that provide end-user services are the LU services manager (LU.SVC_MGR) and 
session presentation services (SPS) component of the half-session (see Figure 
1-3). Although there is only one LU services manager, there can be as many 
half-sessions as the resources of the LU permit. 

For LU-LU sessions, the half-session provides session presentation services 
(SPS). For the SSCP-LU session, the half-session provides session network 
services (SNS) . 

There is a common protocol at the boundary between DFC (data flow control) 
and SPS and SNS. That is, DFC doesn't know whether it has the SPS or SNS 
component above it. DFC controls the flow of function management data (FMD) 
requests and responses between FMD pairs (pairs of SNS components on an 
SSCP-LU session or pairs of SPS components on an LU-LU session). 

Note: FMD is a term used to group the two components that handle function 
management data, SPS and SNS. This book does not use FMD when use of SNS or 
SPS is more precise, but you will see FMD used in the books shown as related 
publications in the Preface. 

The TC (transmission control) component sends and receives data across the 
path control network. 

The remainder of this chapter describes the functions performed by each 
component within the LU. You should refer to Figure 1-3 to see how each 
component relates to the overall structure. 

STRUCTURE OF THE LU SERVICES MANAGER (LU.SVC_MGR) 

The LU services manager activates and deactivates sessions, provides network 
services to the end user, and controls end user interactions with the 
half-sessions so that messages from different sessions are not arbitrarily 
interleaved. The LU services manager has overall recovery and restart 
responsibilities for the LU, but these responsibilities are shared by all 
components. 

A half-session control block (HSCB) exists for each half-session that is not 
reset (in reset state). The HSCB provides storage for all the finite state 
machines (FSMs), queues, lists, and variables used by the half-session. A 
finite state machine is logic that compares an item of input (a search argu- 
ment) against the current state of the system (in our case, the session 
state) and produces an item of output (a result), a state change, or both. 

Included in each HSCB is a set of variables called the half-session acti- 
vation parameters (HSAP). The LU services manager fills the first portion of 
the HSAP with that portion of the BIND SESSION request containing the TS, FM, 
and PS profiles and usage fields so that the LU has access to the protocols 
and capabilities of the half-session. 

The LU services manager is also responsible for initializing the states of 
the half-session being activated. The three half-session components (SPS, 
DFC, and TC) are initialised to the reset state. 
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COMPONENTS OF THE LU SERVICES MANAGER 

The LU services manager provides two categories of service: 

End-user services 
Session network services 

End-user services are those services used when exchanging data between 
session partners. These services are discussed in this book. Session 
network services are those services that the LU uses when coordinating its 
network activity. These services are summarized in the next few paragraphs 
and are defined in detail in SNA Format and Protocol Reference Manual; Archi- 
tecture Logic. 



SESSION NETUORK SERVICES 

The LU services manager interacts with the SSCP services manager 
(SSCP.SVCJMGR) to provide session> configuration, network operator, and 
maintenance and management services. 

Session services are distributed between SSCPs and their LUs. Session 
services enable the SSCP and the LU to activate and deactivate LU-LU 
sessi ons. 

Configuration services control the network's physical configuration. These 
functions include activating and deactivating links between nodes. 

Network operator services handle communication between network operators and 
SSCPs, such as activating a physical or logical unit. 

Maintenance and management services allow an LU and its SSCP to conduct vari- 
ous tests to detect failures within the network. 

The interaction between an LU and its SSCP is based on the division of the 
network into domai ns. Each domain consists of an SSCP and the resources 
(physical units, logical units, and links) that the SSCP controls by having 
the capability to activate them (via the activation requests ACTPU, ACTLU, 
and ACTLINK). 

(For more information on these services, see SNA Format and Protocol Refei — 
ence Manual: Architecture Logic.) 



END USER SERVICES 

The LU services manager provides a protocol boundary to the end user. It 
coordinates end user interactions so that messages from different sessions 
are not arbitrarily interleaved across a destination. 

The two components that provide end-user services are presentation services 
(LU. SVC_MGR.PS) and synchronization services (LU. SVC_MGR. SYNC) . Synchroni- 
zation services are use to restart print jobs in LU_T1 and to synchronize 
distributed data bases in LU T6. 



LU Presentation Services CLU.SVC MGR.PS) 

LU. SVC_MGR.PS correlates a half-session's request for a destination with the 
resources available. Once a resource is selected, the LU services manager 
keeps information on the resource for its own use and the use of the 
half-session. This function is done by UPM. ALLOCATE. (See Note below.) 
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Note: Some of the protocols defined in this book interact directly with 
undefined components; these undefined components, or undefined protocol 
machines (UPMs), generally are not named, shown in block diagrams, or 
discussed in the text. They represent implementation options that are not 
architecturally prescribed or options that are not, as yet, formally speci- 
fied. 

LU Synchronization Services (LU.SVC KGR.SYNC) 

In LU-LU session type 1, an LU can restart printer jobs at its session partner 
by being aware of where the printer head is on the page when an error occurs. 
The LU with the printer takes checkpoints (records its current status) at an 
interval specified by the originating LU. If an error occurs, the printer LU 
notifies the originating LU, and the recovery sequence is started. 

In LU-LU session type 6, an LU can present to its end user(s) an environment 
in which various system resources, such as terminals, data bases, and queuing 
facilities, are allocated and deallocated within the period that a session is 
active. Typically, allocation and deallocat i on are synchronous with the 
attaching of a transaction processing application program to the LU and its 
subsequent termination, or detaching from the LU. 

Frequently, transaction processing involves multiple-step actions, wherein 
all steps must be completed as a unit because only the combined action has 
meaning. For example, correlated records in a distributed data base must all 
be updated in synchronism with each other. Sync point protocols enable the 
two ends of a session to complete each unit of work, either committing to the 
update if no errors occurred, or undoing the unit of work if the 
multiple-step process fails. 

SESSION PRESENTATION SERVICES (HSID_N.SPS) 

Each half-sessi on provides protocols for presenting information to the end 
user in a usable form. These protocols include handling of data streams, 
encoding and compressing data, and error recovery procedures. The end user 
could be an application program or implementation-specific coding that intei — 
acts with a device or medium (for example, a printer, display, or diskette). 
Since devices typi cally need an operator, the operator can be considered as 
part of the end user. 

The structure of SPS is shown in Figure 1-6. The SPS components vary from 
half-session to half-session depending on the LU-LU session type and the PS 
profile specified in BIND SESSION. In addition, the SPS components are 
influenced by the origin or destination that ultimately processes the data. 
For the full names of SPS components, see "Receive Side" and "Send Side" 
below. 



RU Routing 



An RU router routes the MU or DMU to the proper side of SPS, either send or 
receive, depending on the direction of the flow through the session. The RU 
router is not shown in Figure 1-6 to simplify the figure. 
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Data Destination or Data Origin 
Destinati on— Unique A 

Message Unit (DMU) Boundary 



Session Presentation Services (SPS) 




Message Unit (MU) Boundary 

> SEND 

< > CALL 

ACCESS TO CONTROL BLOCK 



Figure 1-6. Session presentation services (SPS) components. SPS processes 
message units (MUs) received from DFC and creates destination-unique message 
units (DMU) which are passed to the selected destination. SPS also receives 
DMUs from the data, origi nator, creates MUs and sends them to DFC. 

Note: FMD is used in the RU category field of the RH as an indication that 
the RU is associated with the data origin or data destination functions of 
SNA. When the RU category field (RU_CTGY) is FMD, the RU router uses 
SPS.RCV.FMD and SPS. SEND. FMD. When RU_CTGY is DFC, the RU router uses 
SPS.RCV.DFC and SPS .SEND. DFC. 
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Receive Si da 



Session presentation services receives requests and responses with an RU_CTGY 
of FMD or DFC across the data flow control boundary from DFC Receive 
(DFC.RCV) as message units (MUs), which consist of a request/response header 
(RH) and request/response unit (RU). It sends destination-unique message 
units (DMUs) across the session protocol boundary to the data origin or data 
destinati on. 

Session presentation services receive (SPS.RCV) enforces the appropriate SPS 
protocols for the MU received. It routes the MU to SPS.RCV.FMD or 
SPS.RCV. DFC depending on RU_CTGY. It is responsible for transforming MUs to 
DMUs across the session protocol boundary to the data origin or data destina- 
tion. 

SPS.RCV. DFC validates DFC requests and responses by calling DFC request 
receive (LT_DFCR) and DFC response receive (LT_DRR), respectively. (Compo- 
nents named LT_xxxx are different for each LU-LU session type.) If LT_DFCR 
indicates a request contains an error, or if LT_DRR indicates a response 
contains an error, then SPS.RCV. DFC changes the request or response to an 
exception request (EXR). 

SPS.RCV.FMD validates FMD requests and responses by calling the following 
procedures, as appropriate: 

• Destination services receive (LTJDSR) validates the formats and protocols 
of function management headers (FMHs) received on the half-session. It 
detects certain FMH protocol and format errors and notifies SPS.RCV of 
those errors. The action LT_DSR takes is based on the FMH it receives: 

FMH-1 - Manages a destination stack, which indicates which destination is 
the active destination and which destinations, if any, have been 
suspended. 

FMH-2 - Validates the data management activity requested by the FMH-2 
against the active destination. 

FMH-3 - Validates the data management acti vi ty requested by the FMH-3 
against all destinations of the half-session. 

FMH-4 - Validates control information against information received in 
previous FMHs. 

FMH-5 - Validates the format of the FMH-5, then uses UPM. ALLOC to acti- 
vate (attach) a process that handles subsequent FMHs and their associated 
data. 

FMH-6 - Validates the command in the FMH-6 against the process attached 
by the FMH-5. 

FMH-7 - Validates that the FMH-7 follows the negative response X f 0846 f . 

FMH-10 - No action. 

• Message unit services receive (LT__MSR) processes requests and responses as 
required by the half-session. LT_MSR deblocks the data stream and vali- 
dates its format. If the data stream format is faulty, LT_MSR notifies 
SPS.RCV.FMD of the error. LT_MSR creates destination unique message units 
(DMUs) to be passed to the selected destination. 

• Compression/Compaction Receive (LT_CCR) decompresses or decompacts the 
data stream as required by the selected destination using information in 
the string control byte (SCB). It detects invalid string control byte 
(SCB) code points or count fields and notifies SPS.RCV.FMD of the error. 

• FMD Response Receive (LT_FRR) processes responses to FMD data units previ- 
ously sent to the other half-session. 
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Send Side 



SPS.RCV passes requests or responses in the form of DMUs to the data origin or 
data destination. All errors detected by LT_DSR, LT_MSR, LT_CCR, LT_FRR or 
SPS.RCV are changed to exception requests (EXR) by SPS.RCV. 



Session presentation services receives requests and responses with an RU_CT6Y 
of FMD or DFC across the session protocol boundary as DMUs, and sends them 
across the data flow control boundary as MUs. 

Session presentation services send (SPS.SEND) enforces the appropriate SPS 
protocol for the DMU received. It routes the DMU to the other SPS components 
as requi red. 

Since DFC. SEND is responsible for sending positive and negative responses to 
the session partner, SPS.SEND provides DFC. SEND with: 

• No notification if the chain is a no-response chain 

• A negative notification to the RU in error when the chain is a definite- or 
exception-response chain 

• A positive notification to the last RU in the chain not found to have an 
error when the chain is a definite- or exception-response chain 

SPS. SEND. DFC validates DFC requests and responses (those identified by 
RU_CTGY of DFC) by calling DFC request send (LT_DFCS) and DFC response 
receive (LT_DRS), respectively. (Components named LT_xxxx are different for 
each LU-LU session type.) 

SPS. SEND. FMD validates FMD requests and responses by calling the following 
procedures, as appropriate: 

• Message unit services send (LT_MSS) validates the syntax and semantics of 

the DMU. 

• Destination services send (LT_DSS) validates the formats and protocols of 
Function Management Headers (FMH) to be sent on the half-session. LT_DSS 
checks for FMH protocol and format violations in the data stream being sent 
to the session partner by SPS. SEND. FMD. LT_DSS also maintains private 
FSMs, such as the destination stack for FMH-1. 

• Compression/compaction send (LT_CCS) compresses or compacts the data stream 
as required for efficient transmitting of the data. LT_CCS builds SCBs, 
inserts them into the data stream, and returns the compressed or compacted 
data stream to SPS .SEND. FMD. 

• FMD Response Send (LT_FRS) processes responses to be sent to the other 
half-session in reply to FMD data units received by this half-session. 

If any SPS.SEND component detects an error, SPS. SEND. DFC or SPS.SEND. FMD 
changes the request or response to an exception request (EXR), and returns 
the EXR to the data origin or data destination. 

SPS finite state machines (SPS.FSM) provides the common FSMs and tables 
required by SPS. These FSMs and tables are available for query and update by 
SPS components. 



Component Matrix 



Each LU-LU session type has some variation of the components depicted in 
Figure 1-6. Figure 1-7 shows that relationship. 
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Figure 1-7. Relationship between session presentation services components 
and LU-LU session types. 
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PART 1 CHAPTER 2. LU-LU SESSION TYPE 1 



Type 1 LU-LU sessions operate in a network controlled by one or more SSCPs. 
One half of the session (called a half-session or session partner) is the 
primary LU (PLU), and the other is the secondary LU (SLU). 

LU-LU session type 1 (LU_T1) is used to manage multiple input and output 
devices associated with a logical unit, such as printers, card readers, card 
punches, and storage devices. An operator console that can be used interac- 
tively or for diagnostic messages is often present. 

Some LU_T1 implementations perform such data management functions as storing 
data for later retrieval and distribution to multiple destinations. Applica- 
tion programs and subsystems may also use LU-LU session type 1 to communicate 
within their network. 

LU__T1 half-sessions operate in an asymmetric environment; that is, the prima- 
ry LU controls the session, and the secondary LU conforms to the primary LU's 
requirements. The primary LU also assumes error recovery responsibility for 
the session. 

The session begins when the primary LU sends a BIND SESSION request to the 
desired session partner. The BIND SESSION request identifies those functions 
the primary LU wishes to use. If the secondary LU's send and receive capabil- 
ity i s comparable, the secondary LU returns a positive response; otherwise, 
it must return a negative response. 

LU_T1 implementations need not contain all functions of the LU_T1 protocol. 
By using BIND SESSION, implementations can determine whether there is a 
subset of functions that allows meaningful communication between session 
partners. 



HALF-SESSION CHARACTERISTICS 



FM, TS, AND PS PROFILES 



LU_T1 implementations use FM profile 3 or 4. Profile 4 allows the LUSTAT (LU 
Status) request to be sent in both directions; whereas profile 3 restricts it 
to secondary-to-primary only. Profile 4 also has a more comprehensive 
qui esce-processi ng protocol than profile 3. 

LU_T1 implementations use TS profile 3 or A. Profile 4 allows the REQUEST 
RECOVERY (RQR) and SET AND TEST SEQUENCE NUMBER (STSN) requests and profile 3 
does not. 

The SNA requests that are allowed with each profile are found in SNA Refei — 

ence Summary. 

For TS profile 3, the current operation is aborted if a session failure 
occurs. For TS profile 4, a checkpoint record is created when the error is 
detected for later STSN-based restart. 

LU_T1 implementations use a PS profile that allows: 

• Function management headers. LU_T1 implementations can run with or without 
FM headers. All FMH-1, FMH-2, and FMH-3 functions discussed in "Part 2 
Chapter 4: Function Management Headers" are allowed with the exception of 
the DSP select field in FMH-1. Data stream profile (DSPs) values can be 
X*0» (default) or X'B' (structured fields). 

The BIND SESSION request contains a presentation services usage field which 
enables its sender to specify an FMH set. In general, the sets are: 
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Set FMH-1 is supported, but only for the default destination. Medium 
selection is not allowed. Set is used by sessions that use 
structured fields in the data stream but otherwise do not use 
FMH-1. The FMH-1 and FM data must be in the same chain, and the 
FMH-1 must both begin and end the destination (see the BEGIN/END 
FMH-1 information under "Using FMH-1 for Destination Selection" in 
Part 2 Chapter 4). No FMH-2s or FMH-3s are allowed. 

Set 1 FMH-1 is supported for &ny destination available to the session. 

The FMH-1 and FM data must be in separate chains. Medium selection 
is allowed; data set selection using DSNAME is not. COMPACTION 
TABLE and PDIR FMH-2s are allowed (see BIND SESSION bytes 16 and 
21). COMPACTION TABLE and QUERY FOR COMPACTION TABLE FMH-3s are 
allowed (see BIND SESSION bytes 16 and 21). 

Set 2 FMH-1 is supported for any destination available to the session. 

The FMH-1 and FM data may be in the same chain. Medium selection is 
allowed; data set selection using DSNAME is not. COMPACTION TABLE 
and PDIR FMH-2s are allowed if specified in BIND SESSION (bytes 16 
and 21). COMPACTION TABLE and QUERY FOR COMPACTION TABLE FMH-3s 
are allowed if specified in BIND SESSION (bytes 16 and 21). 

Set 3 All FMH-1> FMH-2, and FMH-3 functions are supported except as noted 
above for DSP Select field of FMH-1. 

• Data streams. All LU_T1 data streams are based on the SNA character string 
(SCS). The components of the data stream ar& described in Part 2 Chapters 
1, 3, 4, and 5. See "Data Stream Profiles" on page 17 and "Set Structure" 
on page 18 for information on allowed functions. 

• Attended and unattended terminal operations. An operator does not have to 
be present at the terminal if the LU is able to hold messages to the opera- 
tor for delivery when the operator is present. 

TC (TRANSMISSION CONTROL) CONSIDERATIONS 

Transmission Control services, such as pacing and cryptography, are summa- 
rized in SNA Concepts and Products and defined in SNA Format and Protocol 
Reference Manual: Architecture Logic. 

DFC (DATA FL014 CONTROL) CONSIDERATIONS 

Data flow control services, such as chaining, brackets, and send/receive 
modes, are summarised in SNA Concepts and Products and defined i n SNA Format 
and Protocol Reference Manual: Architecture Logic. The following paragraphs 
give additional considerations. 

SEND-RECEIVE MODES 

The following exceptions apply: 

• Half-duplex contention. The secondary half-session is always the 
contention winner (specified in BIND SESSION). If the secondary 
half-session encounters a contention condition, it sends a negative 
response (X'081B' - receiver in transmit mode). It then sends its S->P 
transmission with EC on, or LUSTAT (X'OOOIOOOO* - component available) if 
it cannot start the S->P transmission because of some intervening activity 
at the SLU. (It is possible that this intervening activity may cause the 
P->5 retry to fail also; the operator, for example, may seize the second- 
ary's buffer resource after the LUSTAT is sent.) 

• Half-duplex flip-flop. No exceptions. 

• Full duplex. Not allowed. 
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BRACKET PROTOCOL 



The following exceptions apply: 

• The secondary half-session must be the bracket first speaker as defined in 
BIND SESSION. 

• The primary half-session may send the BID request before transmitting to 
avoid a bracket contention condition (both session partners attempting to 
begin a bracket at the same time). 

• If the primary half-session begins transmitting without first sending BID, 
the RU that begins the bracket (the one that carries BB) must be sent RQD 
(request definite response). 

• Destination selection cannot span brackets. Multiple destinations may be 
selected within a bracket, but only one destination can be active at a 
time. 



HALF-DUPLEX CONTENTION PROTOCOL 

When an LU_T1 session uses half-duplex contention protocol, the primary and 
secondary half-sessions are> in contenti on-to-send state when they are between 
chained transmissions. Either primary half-session or secondary 

half-session can initiate a transmission. Contention is the 

taneous transmissions from the primary and secondary half-se 
bit 3 of the BIND SESSION request defines that the secondary 
wins contention. The contention loser (the primary) receive 

response with sense data indicating that the secondary is in 

When this response is returned, the contention loser must enter receive 
state. The send/receive relationship is in effect for the duration of one 
chained transmission. When the current chain is completed, the primary and 
secondary half-sessions are again in contention for send state. 

HALF-DUPLEX FLIP-FLOP CHANGE-DIRECTION PROTOCOL 

Use of CD Indicator (CDI): The change direction indicator (CDI) in the 
request header (RH) is used to change the direction of data flow when session 
partners ar& using half-duplex flip-flop mode and are within brackets (after 
BB but before EB). To change the direction of flow, the half-session that has 
the authority to send at a given moment turns on the CDI in the last RU it 
sends to its session partner. 

The sending of the CDI should occur under the following circumstances: 

• An LU has reached an end-of-send data-transition condition (including any 
keyboarded data on the LU flow). 

• An LU has received SIG X'0001* (request change direction). The procedures 
that must be followed when returning the CDI are discussed below under 
"Signal Codes." 

• A PLU has been session-activated in the send state, but has no data traffic 
to send. 

• At session activation, the PLU receives a CINIT that indicates that the SLU 
must send data first. 

• When the LU receives CD and the LU does not have the capability to send data 

(for example, a printer). In this case, the CDI is returned as part of 
LUSTAT X'0002' . 

An LU should send available FM data, if any, when the CDI is received. If 
there i s no FM data pending, the LU must wait for additional FM data to send 
or for one of the conditions described above. 
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Use of SIG (Signal): An LU that is capable of sending FM data must be capable 
of sending SIG X'0001 1 (request change direction), under operator control or 
automatically, when in receive state with FM data to send. 

The sender of SIG X'0001' must return the CDI when it has no more data to 
send. 

The receiver of SIG X f 0001» must not send SIG X'0001* after sending the CDI 
until the end-chain indicator (ECI) has been returned. This prevents a 
signal ping/pong condition from occurring with no data flowing. 

Data Direction Resolution: At session activation, the session partners are 
between brackets, and neither is in send state. The PLU normally sends a BID 
request if it wants to enter send state, but it may enter send state by send- 
ing data to the SLU if that data is sent requiring a definite response 
(BB,RQD). The SLU enters send state by sending data to the PLU. The second- 
ary half-session is the contention winner in the event that both PLU and SLU 
attempt to begin a bracket concurrently. 



PS (PRESENTATION SERVICES) CONSIDERATIONS 



FM HEADER PROCESSING 

Primary LUs must be able to access data in data sets located at a secondary LU 
(SLU). There are a number of data set organisations for user data that may 
appear at the secondary LU. Not all of these organi sati ons are supported by 
all SLU implementations. The FMH sets and FMH flags fields of BIND SESSION 
indicate which organisations are supported by specifying which operations are 
allowed on the data sets. The minimum functions for data management, which 
are specified by FMH set 3, consists of all the functions allowed in FMH set 2 
plus an addressed direct data set located at the secondary and accessible by 
the primary. With FMH set 3, the PLU is allowed to issue FMH-1 and the 
REPLACE FMH-2 (using the RECORD ID and PASSWORD FMH-2s) against the SLU data 
sets. The VOLUME ID FMH-2 is supported for the BEGIN and BEGIN/END FMH-ls. 

In addition to this basic level of data management, the FMH flags fields may 
specify that FM headers support other data set organisations and other opei — 
ations on the addressed direct organisation. The additional organisations 
supported are sequential (using ADD) and keyed direct (using ADD and ERASE 
FMH-2s) organisations. The additional functions for addressed direct organ- 
isations are sequential access, using ADD, NOTE and NOTE REPLY FMH-2s. 

The SERIES ID and STATUS FMH-3s are optionally allowed, as are the ADD REPLI- 
CATE and REPLACE REPLICATE FMH-2s. 

The QUERY FOR DATA SET FMH-2 is optionally allowed, but when the BEGIN FMH-1 
is issued that identifies the requested data set, the BEGIN FMH-1 must be the 
only entry in the issuer's send stack. 

The EXECUTE PROGRAM OFFLINE FMH-2 is optionally allowed. 

The file maintenance FMH-2s (CREATE DATA SET, SCRATCH DATA SET, and SCRATCH 
ALL DATA SETS) are optionally allowed. 

If an error occurs. in a chain carrying an FM header, the data following the 
header can be applied to a different data set than was intended. Consider the 
following sequence: 
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BDS, 


DSNAME 


= A 


data 


data 


EDS, 


data. 


RQE 



-RSP 

T Applies to DSNAME = A 
I 
BDS, DSNAME = B 

-RSP 

[ Applies to DSNAME = B 
data 



The rules that avoid this situation are: 

1. If BIND SESSION allows an LU to send RQD and specifies FMH set 3, then any 
FMH-1 or FMH-2 that the LU sends that modifies a resident data set (as 
opposed, for example, to transmitting data for output processing on prin- 
ter, console, or card) must be sent RQD and the LU must wait until the 
response is returned. 

2. A BIND SESSION may be rejected by an SLU if the BIND SESSION specifies 
both (1) FMH set 3, and (2) PLU will only send RQE. 



DATA STREAM PROFILES 



LU__T1 implementations do not use the DSP select field of the FMH-1 to select 
data stream profiles. They either specify X'0 ? so that the profile (data 
stream) is assumed when the medium is selected, or specify X'B* to indicate 
that the data stream contains structured fields. (See "Function Management 
Header Type 1 (FMH-1)" in Part 2 Chapter 4.) 



DATA STREAMS CONTAINING STRUCTURED FIELDS 

Structured fields in LU_T1 are introduced by FMH-ls with the DSP select field 
set to X'B* (structured fields). Reply type structured fields are introduced 
by FMH-ls with the DSP select field set to X'B" and the stack reference indi- 
cator set to B'l'. 

A BEDS FMH-1 (begin/ end destination selection) may be used to carry struc- 
tured fields to SLUs that do not support FMHs for destination selection. 
(See BIND bytes 6 and 15.) 

Structured fields can be implemented in sets based on the structure in Figure 
2-1. 

In order to implement a function in any given set in this structure, a product 
must implement all of the operations defined by that set and all of the ope« — 
ations in previous sets. A product may implement one or more of the sets. 
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SFDATA 



EBASE 



PJR 



CHAR 
<attr> 



ALT 



EXSF 



SPD 



MULTI 



Figure 2-1. Structured field sets. Function sets are used when implementing 
structured fields. If the MULTI set is chosen, the values of <attr> must 
include character sets. Character sets are selected using the Set Attribute 
<attr> control described in Part 2 Chapter 1. 



Set Structure 



The operations required in each set are summarized in the following table and 
defined in full in the following text. 



SET 


QUERY REPLIES 


FUNCTION 


SFDATA 




BEDS FMH-1 

(DSP = X'B f structured fields) 


PJR 




Request Recovery Data structured field 
Recovery Data structured field 
Set Checkpoint Interval structured field 
Restart structured field 


EBASE 


Usable Area 


Read Partition (Query) structured field 


CHAR 


<attr> 


SA <attr> SCS control 
(X f 28') 


ALT 


Character Sets 
(ALT flag =.B'1») 


Graphic Escape SCS control 
(X'08») 


MULTI 


Character Sets 
(MULTI flag on) 


Load Programmed Symbols 
structured field 


EXSF 


Usable Area 

(EXSF flag = B f 0») 


SCS Data structured field 


SPD 


Device Character- 
istics 


Set Print Density SCS control 
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STRUCTURED FIELD SUPPORT (SFDATA): This set supports the structured field 
data stream. If this set is implemented* the half-session must support: 

• BEDS FMH-1 (DSP = Structured Fields) 

Other destination selection options* such as BEGIN and CONTINUE* are optional 
for FMH-ls with DSP = Structured Fields. 

PRINT JOB RESTART (PJR); If this set is implemented, the half-session must 
support: 

• Request Recovery Data structured field 

• Recovery Data structured field 

• Set Checkpoint Interval structured field 

• Restart structured field 

EXTENDED PRESENTATION BASE (EBASE): This is the base set of functions for a 
half-session which supports any of the data presentation functions supported 
by structured fields. If this set is implemented* the half-session must 
support: 

• Read Partition structured field 

(Query operation only) 

• Query Reply (Usable Area) structured field 

• SCS Data structured field 

CHARACTER ATTRIBUTES (CHAR): If this set is implemented, the half-session 
must support: 

• Set Attribute <attr> SCS control 

ALTERNATE CHARACTER SET (ALT): If this set is implemented, the half-session 
must support: 

• Query Reply (Character Sets) structured field 

(with ALT flag set on) 

• Graphic Escape SCS control 

MULTIPLE LANGUAGE CAPABILITY (MULTI): If this set is implemented, the 
half-session must support: 

• Query Reply (Character Sets) s cructured field 

(with MULTI flag set on) 

• Load Programmed Symbols structured field 

EXTENDED STRUCTURED FIELD SUPPORT (EXSF): If this set is implemented, the 
half-session must support: 

• Query Reply (Usable Area) structured fi eld 

(with EXSF flag set to B'O*) 

• SCS Data structured field 

SET PRINT DENSITY (SPD): If this set is implemented, the half-session must 
support: 

• Query Reply (Device Characteristics) structured field 

(with SPD descriptor) 

• Set Print Density SCS control 



STRUCTURED FIELDS USED BY LU_T1 

The following structured fields are common between the structured field data 
stream used by LU_T1 and the SNA 3270 data stream used by LU_T2 and LU_T3: 

• Load Programmed Symbols 

• Read Partition (Query operation) 

• Query Reply 

• SCS Data 
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The following structured fields ar& unique to LU_T1: 

• Set Checkpoint Interval 

• Request Recovery Data 

• Recovery Data 

• Restart 

LOAD PROGRAMMED SYMBOLS: This structured field lets an application program 
load character definition data into a specified PS (programmed symbol) stor- 
age in the device. For details see Part 2 Chapter 3. 

READ PARTITION (QUERY): This structured field lets an application program 
enquire about the definition of the device — what features are present and 
how they are defined. For details see Part 2 Chapter 3. 

QUERY REPLY: This structured field lets the LU to respond to a Read Partition 
(Query). Query replies for character sets, color, and highlighting are 
supported for LU_T1. For details see Part 2 Chapter 3. 

SCS DATA: The SCS Data structured field allows sending of SCS (SNA character 
string) data intermixed with other structured fields. The SCS data portion 
of thi s structured field is treated the same as SCS data not delimited by an 
SCS structured field. For details on the structured field, see Part 2 Chap- 
ter 3. For details on SCS controls, see Part 2 Chapter 1. 

SET CHECKPOINT INTERVAL: Four structured fields sre used for restarting prin- 
ter jobs: 

• Set Checkpoint Interval 

• Request Recovery Data 

• Recovery Data 

• Restart 

The primary LU (PLU) uses Set Checkpoint Interval to send to the secondary LU 
(SLU) the number of pages that are to be in the interval between SLU check- 
points (the SLU is the LU for the printer). When the SLU is capable of 
restarting printer jobs, it takes a checkpoint (that is, records its status) 
when it receives Set Checkpoint Interval and each time it completes the 
interval set by the structured field. The structured field should not be 
sent if the SLU does not restart printer jobs. (See BIND SESSION byte 17 bit 
4.) 

REQUEST RECOVERY DATA: The PLU uses Request Recovery Data to request that the 
SLU send the recovery data for restarting the print job. The structured 
field cannot be followed by other data, and the last RU of the RU chain must 
have the change direction indicator set on. 

RECOVERY DATA: The SLU sends Recovery Data to the PLU in response to Request 
Recovery Data. The Recovery Data structured field contains all the check- 
point information needed to restart the printer job, such as the number of 
pages printed since the last (current) checkpoint, the number of lines print- 
ed on the page where the error occurred, and horizontal and vertical format- 
t i ng controls. 

The checkpoint returned by the SLU is always the one previous to the last, 
except that the SLU never goes back beyond the beginning of the chain. That 
is, it can be as far from the error as: 

(2 X Interval) -1 

Previous Current Error detected 

BC checkpoint checkpoint (active checkpoint) 

I I I X 

A 
I 
Checkpoint returned. 

Note: When checkpoint is used in LU_T1, it refers to the checkpoint returned 
as illustrated above. 
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The Recovery Data structured field contains zeros when there is no recovery 
data or when the SLU is unable to send the proper data. 

The SLU may also send Recovery Data when restarting on an alternate printer, 
but only after receiving Set Checkpoint Interval and Request Recovery Data. 

RESTART: The PLU sends Restart to the SLU after the PLU has been told that the 
error condition has been corrected. The Restart structured field contains 
the number of pages and lines to be bypassed before printing starts again 
using the data that follows the structured field. The PLU ensures that the 
first byte of data, which is in the next RU chain, resumes at the checkpointed 
spot, or at the start of the SCB (string control byte) string or structured 
field containing the checkpointed spot. 



SIGNAL CODES 



SIG is an expedited request that may be sent between half-sessions regardless 
of the normal flows. It carries a 4-byte signal code set by the sending LU. 

The valid signal codes for LU_T1 are: 

X'0001' + 'rrrr' Request to send (0001) and reserved field irrrr^ . 

X'0003' + 'uuuu' Intervention required, no data lost (0003) and 

user defined field. 

For LU__T1 the user defined field is: 

f* /% r\ 4™ rs y\ ^" 

See FMH-1 Byte 2 Bits 0-3 in Part 2 
Chapter 4. 

See FMH-1 Byte 2 Bits 4-7 in Part 2 
Chapter 4. 

X'OO' Undefined intervention 
X'01 1 Out of forms 

If a signal code is received that is not recognized or can not be acted on, it 
may be rejected with a negative response (sense code X'1003* function not 
supported) . 



Bvte 
3 


Bits 
0-3 


Name 

Select medium 




4-7 


Logi cal 
subaddress 


4 


0-7 


Interventi on 
requi red 



LU STATUS (LUSTAT) CODES 



Secondary LUs may send the following status codes in the LUSTAT request. 

0001 Component now available 

0002 No FM data to transmit 

0003 Entering attended mode of operation 

0004 Entering unattended mode of operation 
081C Component failure 

082B Component available but presentation space integrity lost 
0831 Component disconnected (power off or other disconnecting 
condition) 
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ERRORS 



The format of LUSTAT is: 

Byte Value Definition 

X'04' Request code 

1-4 Status value and status extension field 

(two bytes each) 

X'OOOl'+'ccOO' Component now available (0001) and 
component identification (ccOO) 

X' 0002'+* rrrr * No FMD requests to send and reserved field. 

X'0003 f + ' ccOO' Entering attended mode of operation (0003) 
and component identification (ccOO) 

X'0004'+'cc00' Entering unattended mode of operation (0004) 
and component identification (ccOO) 

X'OSlC'+'ccOO' Component failure - permanent error (081C) 
and component identification (ccOO) 

X' 082B'+'cc00 ' Component available, but presentation space 
integrity lost (032B), 
and component identification (ccOO) 

X'OSSl'+'ccOO' Component disconnected (0831) 

and component identification (ccOO) 

Values for *cc* byte are: 

X'00' = LU itself rather than a specific LU component 

Otherwi se, 

Bit 0, set to 1 = media other than LU 

Bits l-3> LU component class: 



'000' 


Console 


'001' 


Exchange 


'010' 


Card 


'011' 


Document 


'100' 


Nonexchange di sk 


'101' 


Extended document 


'110' 


Extended card 



Bits 4-7, LU component device address 
LU_T1 does not allow BB (begin bracket) on LUSTAT. 



All errors are turned into exception requests (EXRs) by the element of the 
network that detects the error. The exception request is sent forward 
(except for loss of path type errors) to the LU named in the DAF (destination 
address field of the transmission header). The LU then processes the EXR and 
returns a negative response if the request was marked definite or exception 
response requested. 
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Errors can be categorized in LU_T1 by this algorithm: 



IF negative response received by SLU THEN 
DO; 

IF path error THEN 
DO; 

Notify operator of loss of session; 
IF running TS profile 4 THEN 
create a checkpoint; 
. ELSE; 
END; 
ELSE 
DO; 

DFC processing required to go to receive state; 
await primary LU error recovery action; 
END; 
END; 
ELSE; 



IF negative response sent by SLU THEN 
DO; 

IF RH error or state error or request error THEN 
DO; 

Purge chains; 
Go to receive state; 
Await primary ERP; 
END; 
ELSE; 

IF contention error (X*081B')» BETB or INB under 
a contention BIND THEN 
DO; 

IF state is/becomes INB and S->P transmission is 
sent THEN 

Continue until EC is sent; 
ELSE; 
IF EC on the normal flow has not been sent 

after the negative response (X'081B ! ) THEN 
Send LUSTAT (X' 00010000 ') ; 
ELSE; 
END; 
ELSE; 
IF brackets reject (0813) or 0814) THEN 

conti nue; 
ELSE; 

IF intervention required (0802) THEN 
DO; 

Supply the intervention locally; 
When it is complete THEN 

Send LUSTAT (X* OOOlccOO « ) ; /* to report that 

** intervention has 
** been supplied */ 
IF another device has been selected 
meanwhile THEN 
The LUSTAT must contain the component ID 
of the device now available; 
ELSE; 
END; 
ELSE; 

IF request reject (08xx) (including 081B) while HDX-FF 
INB Send State THEN 
DO; 

Purge the chain; 
Go to receive state; 
Await primary ERP; 
END; 
ELSE; 
END; 
ELSE; 
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The following algorithm is used at the SLU in order to determi ne whether to 
send intervention required (0802) or request not executable (081C) when a 
device error is detected during an output operation (for example, an out of 
paper condition). 



IF data not lost in attended mode 
DO ; 

Hold paci ng; 

Start a timer of between 
IF timer expires THEN 
Recoverable data loss 



THEN 



and 10 minutes duration; 



1; /* this protects the 
HK network and PLU from 
** resource depletion */ 
ELSE 

Resume pacing when the intervention has been supplied; 
END; 
ELSE; 

IF recoverable data loss = 1 in attended mode THEN 
DO; 

Send intervention required (0S02); 

Go to contention state; 

When intervention has been supplied THEN 

Send LUSTAT (OOOlccOO); /* cc is the component ID*/ 

/* X'00' may be used if no 
** other component has been 
** selected after the 0802 
** response. */ 
END; 
ELSE; 

If unrecoverable data loss or unattended mode THEN 
DO; 

Purge chain; 

Send request not executable (081C); 
Stay in receive state; 
Optionally send RSHUTD; 
END; 
ELSE; 



SENSE CODES AND SENSE DATA 



Function management (FM) errors detected by the PLU are not to be sent to the 
SLU by way of sense codes. The PLU must correct these errors through applica- 
tion program action. 

The following errors may be sent by the SLU: (For a complete description of 
each sense code, see SNA Format and Protocol Reference Manual: Architecture 
Logi c . ) 



State Errors: 



20xx 



2002 
2003 



Chaining error 
Bracket error 



Request Errors: lOxx 



1001 

1002 

1003 

1005' 

1008 



RU data error 
RU length error 
Function not supported 
Parameter error 
Invalid FM header 



When 1008, Invalid FM header, is returned, bytes 
2 and 3 of the sense may contain X'0000 f , or may 
optionally contain a detailed explanation of the 
FM header error, as follows: 

1008 0801 Invalid function code parameters 
1008 0803 Forms function cannot be performed 
1008 0805 Unable to perform copy function 
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1008 0806 Compaction table outside supported set 

1008 0807 Invalid PDIR identifier 

1008 0808 Printer train function cannot be performed 

1008 0809 FCB load function cannot be performed 

1008 080A FCB load function not supported 

1008 080B Invalid compaction table name 

1008 080C Invalid ACCESS 

1008 080D Invalid RECLEN 

1008 080E Invalid NUMRECS 

1008 0S0F Data set in use 

1008 0810 Data set not found 

1008 0811 Invalid password 

1008 0812 Function not allowed for destination 

1008 0813 Record too long 

1008 0814 Data set full 

1008 0815 Invalid RECID 

1008 0817 Invalid VOLID format 

1008 0818 Number of logical records per chain exceeded 

1008 0819 Data set exists 

1008 081A No space available 

1008 081B Invalid VOLID 

1008 0S1C Invalid DSACCESS 

1008 081D Invalid RECTYPE 

1008 081E Insufficient resolution space 

1008 081F Invalid key technique 

1008 0820 Invalid key displacement 

1008 0821 Invalid key 

1008 0822 Invalid N (number) 

1008 0823 Invalid KEYIND 

1008 0824 Invalid SERID 

1008 0826 Invalid RECID format 

1008 0827 Password not supplied 

1008 0828 Record ID not supplied 

1008 0829 Volume ID not supplied 

1008 082A Invalid PGMNAME 

1008 2001 Invalid destination — active 

100S 2002 Invalid destination — inactive 

1008 2003 Invalid destination — suspended 

1008 2004 Invalid Suspend-Resume sequence 

1008 2005 Interruption level violation 

1008 2006 Invalid resume properties 

1008 2007 Destination not available 

1008 2008 Invalid end sequence 

1008 2009 Invalid FM header length 

1008 200A Invalid field setting 

1008 200B Invalid destination 

1008 200C Invalid ERCL 

1008 200D Invalid DST 

1008 200E Invalid concatenation 

1008 200F FM data not allowed for header 

1008 2010 BIND FM header set violation 

1008 2014 FM header not sent concatenated 

1008 2019 Invalid stack reference indicator (SRI) 

1008 201A Unable to accept CMI modification 

1008 201B Unable to accept CPI modification 

1008 201C Unable to accept ERCL modification 

1008 4001 Invalid FMH type 

1008 4002 Invalid FMH code 

1008 4003 Compression not supported 

1008 4004 Compaction not supported 

1008 4005 Basic exchange not supported 

1008 4006 Only basic exchange supported 

1008 4007 Medium not supported 

1008 4008 Code selection compression violation 

1008 4009 FMKC not supported 

1008 400A Demand select not supported 

1008 400B DSNAME not supported 

1008 400C Invalid media subaddress field 

1008 400D Insufficient resources to perform function requested 

1008 400E DSP select not supported 
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Request Reject: 08xx 

0802 Intervention required 

0S05 Session limit exceeded (in response to BIND) 

080A Permission rejected - SSCP not notified 

(contrast with 0845) 

080B Bracket race error 

0811 Break 

0812 Insufficient resource 

0813 Bracket bid reject - No RTR forthcoming 

0814 Bracket bid reject - RTR forthcoming 
081B Receiver in transmit mode 

081C Request not executable 

0821 Invalid session parameter (in response to BIND) 

0825 Component not available 

0829 Change direction required 

0S2B Presentation space integrity lost 

0831 LU component disconnected 

0845 Permission rejected - SSCP will be notified 

(contrast with 080A) 

084C Permanent insufficient resource 

0860 Function not supported - continue session 

0862 Medium presentation space recovery 

0863 Referenced local character set identifier (LCID) not found 
0871 Read partition state error 
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BIND SESSION FORMAT FOR LU-LU SESSION TYPE 1 

This section defines valid bit settings for the BIND request. The BIND send- 
er selects the values to be used. Any value may be specified except those 
identified as not valid. All values listed must be supported by the BIND 
receiver unless the value is optional (identified by X in the Opt column) or 
not valid. 

Byte Bi ts Value Opt Pi scussi on 

0-7 X'31 1 Identifies this RU as a BIND request 

1 0-3 X'0» Specifies the format of the BIND RU. Only one format has been 

defined: format (zero). 

(1) 4-7 Type - denotes the type of BIND to be performed 

X'0 f Not valid 
X'l' Nonnegotiable BIND 

FM (Function Management) Profile 

2 0-7 X'03' FM profile 3 

X'04' X FM profile 4 



The FM profile defines the data flow control (DFC) protocols to 
be used for this session. (See SNA Reference Summary for high- 
lights of the FM profile.) 



TS (Transmission Subsystem) Profile 



0-7 X'03 1 TS profile 3 
X'04* X TS profile 4 



The TS profile defines the transmission control (TO protocols 
to be used for this session. (See SNA Reference Summary for 
highlights of the FM profile.) 



FM Usage 

(4-7) See bytes 4 through 7 below. 

Primary Half-Session Protocols for FM Data 

Chai ning Use: 

4 B'O' Primary half-session can send only single element chains. 
B , l f Primary half-session can send single or multiple element 
chains. 

Request Mode Selection: 

(4) 1 B'O 1 Immediate request mode is used. Only one definite response can 

be outstanding at a time. That response must be received before 
the primary half-session can send another RU. 
B'l' X Delayed request mode is used. Multiple definite responses can 
be outstanding at one time. The sender of data in delayed 
request mode must be responsible for recovery. 
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Byte Bi ts Value Opt Pi scussi on 

Chaining Responses: 

(4) 2-3 B'OO* Not valid 

B'Ql* Primary half-session can request only exception responses. 
B'10* Primary half-session can request only definite responses. 
B'll* Primary half-session can request definite or exception 
responses. 

Notet Secondary half-session is not required to accept "only 
exception response" in BIND when FM header set 3 is specified in 
byte 15. 

(4) 4-5 Reserved 

Compression Indicator: 

(4) 6 B'0 ? Primary half-session cannot send compressed data. 
B'l* X Primary half-session can send compressed data. 

Note: B'l 1 is valid only if the code is EBCDIC (see byte 6 bit 
4). 

Send End Bracket Indicator: 

(4) 7 B'O' X Primary half-session will not send EB. 

B'l 1 Primary half-session can send EB. 

Secondary Half-Session Protocols for FM Data 

Chai ni ng Use: 

5 B'O' X Secondary half-session can only send single element chains. 
B'l' Secondary half-session can send single or multiple element 
chains. 

Request Mode Selection: 

(5) 1 B'O' Immediate Request Mode is used. Secondary half-session can 

issue a request for a single definite response. No further 
transmission is sent until the secondary half-session receives 
the requested response. 
B'l' Delayed request mode is used. Secondary half-session allows 
several definite responses to be outstanding at one time. 

Chaining Responses: 

(5) 2-3 B'OO' Not valid 

B'Ol 1 Secondary half-session can request only exception responses. 
B'10* Secondary half-session can request only definite responses. 
B'll* Secondary half-session can request either definite or exception 
responses. 

(5) 4-5 Reserved 

Compression Indicator: 

(5) 6 B'O' Secondary half-session cannot send compressed data. 
B'l* X Secondary half-session can send compressed data. 



Note: B'l" is valid only if the code is EBCDIC (see byte 6 bit 
4). 



Send End Bracket Indicator: 

(5) 7 B'O' Secondary half-session cannot send EB. 
B'l' Secondary half-session can send EB. 
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Bvte Bits Value Opt Pi scussi on 
Common Protocols -for FM D? ta 

6 Reserved 

(6) 1 B'O' Primary half-session and secondary half-session cannot exchange 

FM headers. 
B'l* X Primary half-session and secondary half-session can exchange FM 
headers. 

Brackets Usage and Reset State: 

(6) 2 B'O' Not valid 

B'l 1 Brackets are used and bracket state manager's reset state is 
BETB (between brackets) . 

Bracket Termination Rule Selection: 

(6) 3 B'0 f X Bracket termination rule 2 is used. A bracket is terminated 

unconditionally when the last request of the chain that has EB 
in its first request is processed, regardless of the form of 
response requested. 
B'l* Bracket termination rule 1 is used. Bracket termination is 

controlled by the form of response requested (definite or excep- 
tion) for the chain containing (-BB,EB). 

Alternate Code Selection: 

(6) 4 B'Q* Alternate code set will not be used. 
B'l* X Alternate code set may be used. 

If byte 6, bit 4, is B'l*> the code selection indicator (CSI 
field of the RH (request header)) controls whether the alternate 
code i s to be used: 

CSI of = EBCDIC 
CSI of 1 = ASCII 

(6) 5-7 Reserved 

Normal-Flow Send and Receive Mode Selection: 

7 0-1 B'00' Not valid 

B'Ol' X Half-Duplex Contention 

Primary half-session and secondary half-session are in 
contenti on-to-send state when they are between chained trans- 
mi ssi ons. 

B'10 f Half-Duplex Flip-Flop 

B'll 1 Reserved 

Recovery Responsibility: 

(7) 2 B'O* The contention loser is responsible for any error recovery 

attempts for the session. 
B'l 1 X Symmetric responsibility for recovery. The sender of data is 
responsible for recovery. The receiver of data purges to the 
synchronising event* then awaits sender action. 

Contention Winner/Loser: 

(7) 3 B'C Secondary half-session is contention winner (and therefore the 

brackets first speaker) and primary half-session is contention 
loser. 
B'l* Not valid 

(7) 4-6 Reserved 
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Byte Bi ts Value Opt Pi scussi on 

Half-Duplex Flip-Flop CHDX-FF) Reset States: 

(7) 7 Reserved 

TS Usage 

(8-13) See bytes 8 through 13 below. 

Staging Indicator and Pacing Count for Secondary CPMGR (con- 
nection point manager) to Primary CPMGR normal flow: 

8 B ? f Pacing in this direction occurs in one stage. 

B , l* Pacing in this direction occurs in two stages. 

Note: The meanings of and 1 are reversed from the staging 
indicator for primary CPMGR to secondary CPMGR (see byte 12). 

(8) 1 Reserved 

(8) 2-7 B'nnnnnn' Secondary CPMGR send pacing count. A value of 000000 means no 

pacing of requests flowing from the secondary. 

9 0-1 Reserved 

(9) 2-7 B'nnnnnn* Secondary CPMGR receive pacing count. A value of 000000 causes 

the boundary function to substitute the value set by a system 
definition pacing parameter (if ■the system definition includes 
such a parameter) before it sends the BIND RU on to the second- 
ary LU. A value of 000000 received at the secondary LU is 
interpreted to mean no pacing of requests flowing to the second- 
ary LU. 

10 X'abV X Maximum RU size sent on the normal flow by the secondary 

half-session. This value represents the largest RU that can be 
sent. It is expressed as a mantissa and an exponent value of 2 
by which the mantissa is multiplied. 

X^S" if the mantissa is 8 and the exponent is 5 (X'85 1 ), the RU size 
is 256 bytes (8 x 2 5 ). 

B'On... 1 When bit is set to zero, no maximum is specified and the 

remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab'. See Appendix B for these values. 

Note: All LU_T1 implementations must support receiving an RU of 
256 bytes and accept BINDs that say the smallest maximum RU send 
size is 256 bytes. 

11 X f ab T X Maximum RU size sent on the normal flow by the primary 

half-session. This value represents the largest RU that can be 
sent by the primary half-session and is specified in the same 
format as the secondary half-session (byte 10). 

X^S 1 if the mantissa is 8 and the exponent is 5 (X*85 f ), the RU size 
is 256 bytes (8 x 2 s ). 

B*0n... f When bit is set to zero, no maximum is specified and the 

remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab'. Staging Indicator and Pacing 
Count for Primary CPMGR to Secondary CPMGR normal flow: 

12 B f 0* Pacing in this direction occurs in two stages. 

B'1 T Pacing in this direction occurs in one stage. 

Note: The meanings of and 1 are reversed from the staging 
indicator for secondary CPMGR to primary CPMGR (see byte 8). 

(12) 1 Reserved 
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Bvte Bi ts Value Opt Pi scussi on 

(12) 2-7 B'nnnnnn' Primary CPMGR send pacing count. A value of 000000 causes the 

value set by a system definition pacing parameter (if the system 
definition includes such a parameter) to be assumed for the 
session. If this is also 000000, it means no pacing of requests 
flowing from the primary. 

For single-stage pacing in the primary-to-secondary direction, 
this field is redundant with, and will indicate the same value 
as, the secondary CPMGR receive pacing count (see byte 9, bits 
2-7 above) . 

13 0-1 Reserved 

(13) 2-7 B'nnnnnn* Primary CPMGR receive pacing count. A value of 000000 means no 

pacing of requests that flow to the primary. For single-stage 
pacing in the secondary-to-primary direction, this field is 
— idundant with, and will indicate the same value as, the second- 
ly CPMGR send pacing count (see byte 8, bits 2-7 above). 



re< 
ary 



PS Profile 

(14-25) See bytes 14 through 25 below. 

14 B f f PS usage field format is the basic format 

B f l f Reserved 

(14) 1-7 B'0000001' LU-LU session type 1 



PS Usage 

15 0-3 FM Header Sets: 

X f 0» X FM header set 0. BEDS FMH-1 allowed for default destination 
only. 

X*l f X FM header set 1. FMH-ls have no data set name field; restricted 
header and data combinations. 

X f 2 f X FM header set 2. FMH-ls have no data set name field; less 
restricted header and data combinations. 

Note: The difference between sets 1 and 2 is that 2 allows 
headers and data in the same chain. Set 1 allows the use of 
headers and data together only on the BEGIN/END (BEDS) FMH-1. 

X'3 f X FM header set 3. Data management headers. 

The base functions of data management are specified by set 3. 
An Addressed Direct data set located at the secondary 
half-session is accessible by the primary half-session. With 
set 3, the primary half-session is allowed to issue FMH-ls and 
the REPLACE FMH-2 (using the RECORD ID and PASSWORD FMH-2s) 
against the secondary half-session data sets. The VOLUME ID 
FMH-2 is valid with FMH-ls that begin destinations. 

(15) 4-7 X f 0' Data stream profile (SCS parameters and card data streams must 

not span RUs) . 
X'l* X Data stream profile 1 (SCS parameters and card data streams may 
span RUs) . 
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Byte Bi ts Value Opt Pi scussi on 
Primary Half-Session Usage 



(16-20) 



• •• Flags for FM header 

16 0-7 

17 0-3 
(17) 4-7 

• •• Flags for FM header 
16 B'O' 

B'l' X 



(16) 1 
(16) 2 



B'0 f 
B'l' 

B'O' 
B'l' 



(16) 3-7 
17 0-3 

(17) 4-7 

••• Flags for FM header 
16 



(16) 1 

(16) 2 

(16) 3 

(16) 4 

(16) 5 

(16) 6 

(16) 7 

17 



B' 


0' 


B' 


1' 


B' 


0' 
1' 


B< 
B' 


0' 
1' 


B' 


0' 
1' 


B 


0' 
1' 


B 
B 


'0' 
1' 


B 
B 


'0' 
'1' 


B 
B 


'0' 
'1' 



(Secondary Half-Session Receive Capability) 

Bytes 16-17 contain FM header flags- 
Bytes 18-19 contain data stream flags. 
Byte 20 contains media flags. 

FM Header Flags: 

set 

Reserved 

Reserved 

Reserved 

set 1 or 2 

Two destinations may be outstanding. The primary half-session 
may interrupt itself once. 

Three destinations may be outstanding. The primary 
half-session may interrupt itself twice. 

Compacted data must not be sent. 
Compacted data may be sent. 

PDIR not allowed. 

PDIR may be sent by primary half-session. 

Reserved 

Reserved 

Reserved 

set 3 

Two destinations may be outstanding. The primary half-session 
may interrupt itself once. 

Three destinations may be outstanding. The primary 
half-session may interrupt itself twice. 

Compacted data must not be sent. 
Compacted data may be sent. 

PDIR not allowed. 

PDIR may be sent by primary half-session. 

Keyed Direct data sets not allowed. 

Keyed Direct data sets allowed. (Permits use of ADD, ERASE, and 

RECORD ID FMH-2s on Keyed Direct data sets.) 

Sequential data sets not allowed. 

Sequential data sets allowed. (Permits use of ADD and ERASE 

FMH-2s.) 

Sequential access to addressed di rect data sets not allowed. 
Sequential access to addressed direct data sets allowed. (Per- 
mits use of ADD, NOTE, and NOTE REPLY FMH-2s.) 

Use of SERIES ID and STATUS FMH-3s not allowed. 
Use of SERIES ID and STATUS FMH-3s allowed. 

Use of ADD REPLICATE and REPLACE REPLICATE FMH-2s not allowed. 
Use of ADD REPLICATE and REPLACE REPLICATE FMH-2s allowed. 

Reserved 
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Byte 


Bits 


Value 


(17) 


1 


B'O' 
B'l' 


(17) 


2 


B'O' 

B'l 1 


(17) 


3 


B'O' 
B'l' 


(17) 


4-7 




(18-19) 





18 



(18) 



(18) 



(18) 



B'O 



B'l 



B'O' 
B'l' 



B'O 
B'l 



B'O 
B'l 



(18) 


4 


B'O' 
B'l' 


X 


(18) 


5 






(18) 


6 


B'O' 
B'l' 


X 


(18) 


7 


B'O' 








B'l' 


X 


19 





B'O' 
B'l' 


X 


(19) 


1 


B'O' 





B'l 



Opt Pi 5CU55J on 

Use of QUERY FOR DATA SET FMH-2 not allowed. 
X Use of QUERY FOR DATA SET FMH-2 allowed. 

Use of CREATE DATA SET, SCRATCH DATA SET, and SCRATCH ALL DATA 
SETS FMH-2s not allowed. 
X Use of CREATE DATA SET, SCRATCH DATA SET, and SCRATCH ALL DATA 
SETS FMH-2s allowed. 

Use of EXECUTE PROGRAM OFFLINE FMH-2 not allowed. 
X Use of EXECUTE PROGRAM OFFLINE FMH-2 allowed. 

Reserved 

Data Stream Flags 

Note: There is a hierarchy of support within data streams (byte 
18, bits 0-3); that is, if horizontal format is supported, so 
must the full-base and the base data streams. 

Base 

NL (new line) 

FF (form feed) 
X Full base 

Includes: base data stream plus 

BS (backspace) 

CR (carriage return) 

INP (inhibit presentation) 

ENP (enable presentation) 

LF (line feed) - defaultable 

HT (horizontal tab) - defaultable 

VT (vertical tab) - defaultable 
Defaults are defined in Part 2 Chapter 1. 

Horizontal format must not be used. 
X Horizontal format may be used. 
Includes: full base plus 

SHF (set horizontal format) 
(with parameters) 

Vertical format must not be used. 
X Vertical format may be used. 

Includes: Horizontal format plus 
SVF (set vertical format) 
(with parameters) 

Vertical channel must not be used. 
X Vertical channel may be used. 
Includes: Vertical format plus 
VCS (vertical channel select) 
(with parameters) 

SLD (set line density) must not be used. 
SLD may be used. 

Reserved 

BEL (bell) must not be used. 
BEL may be used. 

TRN (transparent) and IRS (interchange record separator) must 

not be used. 

TRN and IRS may be used. 

Secondary half-session will initiate attended mode. 
Secondary half-session will initiate unattended mode. 

During session, secondary half-session will not alternate from 
attended to unattended mode. 

During session, secondary half-session may alternate between 
attended and unattended mode. 
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Bvte 


Bits 


(19) 


2-7 


20 




C20) 





(20) 


1 


(20) 


2 


(20) 


3 


(20) 


4 


(20) 


5 


(20) 


6 



(20) 



Value Opt Pi scussi on 

Reserved 

Media flags 

Document format is not allowed. 
X Document format is allowed. 

Card format is not allowed. 
X Card format is allowed. 

Exchange media format is not allowed. 
X Exchange media format is allowed. 

Disk data management format is not allowed. 
X Disk data management format is allowed. 

Extended card format is not allowed. 
X Extended card format is allowed. 

Extended document format is not allowed. 
X Extended document format is allowed. 

Secondary half-session may send CD at EDS (end of destination 
selecti on) . 
X Secondary half-session must send CD at EDS. 

Reserved 



B' 
B' 


0» 
1» 


B 
B 


0» 
1" 


B 

B' 


0' 
1* 


B 
B 


0» 
l f 


B 
B 


0» 

'1' 


B 
B 


0' 

l f 


B 


'0' 


B 


1' 



Secondary Half-Session Usage 



(21-25) 



(Primary Half-Session Receive Capability) 

Bytes 21-22 contain FM header flags. 
Bytes 23-24 contain data stream flags. 
Byte 25 contains media flags. 



••• Flags 

21 0-7 

22 0-3 
(22) 4 

(22) 5-7 
••• Flags 

21 

(21) 1 
(21) 2 

(21) 3-7 

22 0-3 
4-7 



FM Header Flags: 
for FM header set 

Reserved 
Reserved 



B'O* Use of structured field for ERP not allowed. 
B f l' X Use of structured field for ERP allowed. 

B f 00 f Reserved 



for FM header set 1 or 2 
B'0» 
B»l»' 



Two destinations may be outstanding. The secondary 
half-session may interrupt itself once. 
Three destinations may be outstanding. The secondary 
half-session may interrupt itself twice. 



B'0* Compacted data must not be sent. 
B'l" X Compacted data may be sent. 

B'0' PDIR not allowed. 

B'l* X PDIR may be sent by secondary half-session. 

Reserved 

Reserved 
Reserved 
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Byte Bi ts Value Opt Pi scussi on 
♦•• Flags for FM header set 3 



21 



(21) 


1 


(21) 


2 


(21) 


3 



(21) 4 

(21) 5 

(21) 6 

(21) 7 

22 

(22) 1 

(22) 2 

(22) 3 

(22) 4-7 
(23-24) 

23 



B'O' Two destinations may be outstanding. The secondary 

half-session may interrupt itself once. 
B'l' X Three destinations may be outstanding. The secondary 

half-session may interrupt itself twice. 

B'O' Compacted data must not be sent. 
B'l' X Compacted data may be sent. 

B'O' PDIR not allowed. 

B f l f X PDIR may be sent by secondary half-session. 

B'O' Keyed direct data sets not allowed. 

B'l' X Keyed direct data sets allowed. (Permits use of ADD, ERASE, and 
RECORD ID FMH-2s on keyed direct data sets.) 

B'0 f Sequential data sets not allowed. 

B'l' X Sequential data sets allowed. (Permits use of ADD and ERASE 
FMH-2s.) 

B'O* Sequential access to addressed direct data sets not allowed. 
B f l' X Sequential access to addressed direct data sets allowed. (Pel — 
mits use of ADD, NOTE, and NOTE REPLY FMH-2s.) 

B'O 1 Use of SERIES ID and STATUS FMH-3s not allowed. 
B'l' X Use of SERIES ID and STATUS FMH-3s allowed. 

B'O 1 Use of ADD REPLICATE and REPLACE REPLICATE FMH-2s not allowed. 
B'l' X Use of ADD REPLICATE and REPLACE REPLICATE FMH-2s allowed. 

Reserved 

B'O' Use of QUERY FOR DATA SET FMH-2 not allowed. 
B'l' X Use of QUERY FOR DATA SET FMH-2 allowed. 

B'O' Use of CREATE DATA SET, SCRATCH DATA SET, and SCRATCH ALL DATA 

SETS FMH-2s not allowed. 
B'l' X Use of CREATE DATA SET, SCRATCH DATA SET, and SCRATCH ALL DATA 

SETS FMH-2s allowed. 

B'O' Use of EXECUTE PROGRAM OFFLINE FMH-2 not allowed. 
B'l' X Use of EXECUTE PROGRAM OFFLINE FMH-2 allowed. 

Reserved 

Data Stream Flags 

Note: There is a hierarchy of support within data streams (byte 
23, bits 0-3). That is, if horizontal format is supported, so 
must the full-base and the base data streams. 

B'O' Base 

Includes (for console devices): 

NL (new line) 

FF (form feed) 
B'l' X Full base 

Includes: Base data stream plus 

BS (backspace) 

CR (carriage return) 

INP (inhibit presentation) 

ENP (enable presentation) 

LF (line feed) - defaultable 

HT (horizontal tab) - defaultable 

VT (vertical tab) - defaultable 
Defaults are defined in Part 2 Chapter 1. 
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Byte 
(23) 



(23) 



(23) 



Bi ts Value Opt Pi scussi on 



B'O 
B'l 



B'O' 
B'l' 



B'O' 

B'l' 



(23) 


4 


B'O* 
B'l' 


(23) 


5 




(23) 


6 


B'O' 
B'l' 


(23) 


7 


B'O' 
B'l' 



24 


0-7 




25 






(25) 





B 
B 


(25) 


1 


B 
B 


(25) 


2 


B 
B 


(25) 


3 


B 
B 


(25) 


4 


B 
B 


(25) 


5 


B 
B 


(25) 


6-7 





Horizontal format must not be used. 
X Horizontal format may be used. 
Includes: Full base plus 

SHF (set horizontal format) 
(with parameters) 

Vertical format must not be used. 
X Vertical format may be used. 

Includes: Horizontal format plus 
SVF (set vertical format) 
(with parameters) 

Vertical channel must not be used. 
X Vertical channel may be used. 
Includes: Vertical format plus 
VCS (vertical channel select) 
(with parameters) 

SLD (set line density) must not be used. 
X SLD may be used. 

Reserved 

BEL (bell) must not be used. 
X BEL may be used. 

TRN (transparent) and IRS (interchange record separator) must 
not be used. 
X TRN and IRS may be used. 

Reserved 

Media flags 

Document format is not allowed. 
X Document format is allowed. 

Card format is not allowed. 
X Card format is allowed. 

Exchange media format is not allowed. 
X Exchange media format is allowed. 

Disk data management format is not allowed. 
X Disk data management format is allowed. 

Extended card format i s not allowed. 
X Extended card format is allowed. 

Extended document format is not allowed. 
X Extended document format is allowed. 

Reserved 



Cryptography Options 



26 



0-1 



B'00' 
B'01» 



B'10 
B'll 



Private cryptography options: 

X No private cryptography supported. 

X Private cryptography supported. The session cryptography key 

and cryptography protocols are privately supplied by the end 

user. 

Reserved 

Reserved 
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Byte Bi ts Value Opt Pi scussi on 

(26) 2-3 Session-level cryptography opti ons: 

B'OO* X No session-level cryptography supported. 

B'01' X Session-level selective cryptography supported. All cryptogra- 
phy key management is supported by the SSCP and LU; exchange 
(using +RSP to BIND) and verification (using CRV) of the cryp- 
tography session-seed value are supported by the LUs for the 
session. All FM data requests with EDI (enciphered data indica- 
tor) on are enciphered/deciphered. 

B'lO" Reserved 

B , ll f X Session-level mandatory cryptography supported; same as 
session-level selective cryptography except all FM data 
requests are enciphered/deciphered. 

(26) 4-7 Session-level cryptography options field length: 

X'O* X No session-level cryptography specified. The cryptography 

option fields (bytes 27-k) are omitted. 
X. 1 9 1 X Session-level cryptography specified. Additional options 

follow in the next nine bytes. 

27 0-1 Session cryptography key encipherment mode: 

B f 00' X Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key using a seed value of zero (only 
value def i ned) . 

(27) 2-4 Reserved 

(27) 5-7 Cryptography cipher method: 

B f 000' X Block chaining with seed and cipher text feedback* using the 

data encryption standard (DES) algorithm (only value defined). 

28-k X Session cryptography key enciphered under BIND receiver (or 

SLU) master cryptography key; an 8-byte value that, when deci- 
phered, yields the session cryptography key used for enciphei — 
i ng and deciphering FM data requests. 

Names and End User Data 

k+1 Length of BIND sender's (or PLU) name in field k+2-m. 

X'OO' Field k+2-m does not exist. 

X f nn* X Field k+2-m contains the number of bytes specified (cannot 
exceed X'08»). 

k+2-m X BIND sender's (or PLU) name. 

m+1 Length of user data in field m+2-n. 

X'OO" Field m+2-n does not exist. 

X'nn' X Field m+2-n contains the number of bytes specified. 

m+2-n X User data 

m+2 X User data key. 

X'00' X Structured subfields follow. 

-X'OO' X First byte of unstructured user data. 

Note: The unstructured user data continues in m+3 and goes to 
byte n. For information on structured subfields, see the BIND 
information in SNA Format and Protocol Reference Manual: Archi- 
tecture Logic. 
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Byte Bi ts Value Opt Pi scussi on 

n+1 Length of user request correlation field. 

Field n + 2-p does not exist. 

Field n+2-p contains the number of bytes specified. 

User request correlation field. 

Length of BIND receiver's (or SLU) name in field p+2-r. 

Field p+2-r does not exist. 

Field p+2-r contains the number of bytes specified (cannot 

exceed X'08'). 

BIND receiver's (or SLU's) name. 





X'OO' 






X'nn' 


X 


n+2-p 




X 


P+l 


X'OO' 






X'nn' 


X 


P+2-r 




X 



Not@S 



The following notes apply to the BIND SESSION request: 

Note 1. The buffer contention error (081B) response cannot be sent by the 
primary half-session, since the secondary half-session wins contention. 

Note 2. There is never an EB race in LU_T1 because the only time 
multiple-chain brackets with EB are sent from the secondary half-session is 
under the HDX-FF BIND option. 

Note 3. If BIND allows the secondary half-session to send requests in either 
exception response form or definite response form, the secondary half-session 
always uses the definite response form unless it has enough logic to under- 
stand additional data-dependent protocols implied by the primary 
half-session name. 

Note 4. If compression/compaction is used, all RUs in a chain being 
compressed/compacted must contain an SCB as their first byte (after any FM 
headers). This implies that the first RU of the chain (or the only RU of the 
chain) resets SCB chaining. 
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PART 1 CHAPTER 3. LU-LU SESSION TYPE 2 



Type 2 LU-LU sessions support data communication between an application 
program and a single display device using the SNA 3270 data stream. Type 2 
sessions allow users to migrate existing customer-written 3270 application 
programs into an SNA network. 

Type 2 sessions associate a single device with the SLU. The logical device 
within the SLU is visible to the PLU. Consistency is maintained between a 
given physical device and the LU for the duration of a unit of work, for exam- 
ple, a bracket. The same physical device is always associated with a partic- 
ular SLU. The device may be dedicated permanently or dedicated only for the 
duration of a bracket or a session; however, it is always the same physical 
device. Except where otherwise noted, the description assumes a dedicated 
display device. 

Products that use type 2 sessions use the SNA 3270 data stream. The data 
stream is introduced in Part 2 Chapter 2. For details of the data stream, see 
3270 Data Stream Programmer's Reference. When the following options &r& 
implemented, they must conform to the protocols of the SNA 3270 data stream: 

1. Selector pen. When a selector pen is implemented, providing the amper- 
sand (&) designator to simulate an Enter key is optional. 

2. Extended screen size. The SLU supports either a 480- or 1920-character 
screen size operation. When the screen is physically larger, the screen 
wraps at the 480 or 1920 point, depending on the value specified in byte 
24 of the BIND SESSION request. 

The SLU may support larger or smaller screen sizes; up to a 4096-byte 
addressing limit with 14-bit addressing, and up to 65,536 with 16-bit 
addressing. 

3. Screen size switching. An SLU has the option of providing dynamic screen 
size switching. The screen size may be switched between two values, 
specified in BIND SESSION during session activation, by the Erase/Write 
and the Erase/Write Alternate commands. The Erase/Write command selects 
the default size while the Erase/Write Alternate command selects the 
alternate size. The screen size is initialized to the default size. 

4. Display of lowercase. Lowercase alphabetic characters sent to the 
display or entered from the keyboard are stored as lowercase but will be 
displayed as uppercase on those devices that can't display lowercase 
characters. 

5. Magnetic stripe reader. The numeric and alphanumeric character sets are 
supported. 

The above options can be implemented using a base set of data stream func- 
tions. The SNA 3270 data stream has additional functions that provide the 
following functions for LU-LU session type 2 implementations: 

1. Screen sizes smaller than 480 characters 

2. Partitioning. The display screen can be divided into several rectangular 
areas. The operator interacts with one area at a time, but may jump from 
one area to another if necessary. 

3. Scrolling. Scrolling allows a presentation space to be larger than the 
viewing area the operator sees. The operator can use the scrolling func- 
tion to display different portions of the character data available at the 
termi nal . 

4. Character sets, color, and highlighting. The application program can 
control the character set to be used for a field or character, as well as 
control the characters color and any emphasis that it should have (such 
as blinking or underlining). 
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5. Field validation. Field validation functions that can be provided are 
(1) checking a field to ensure that the operator filled every character 
position in it, (2) requiring the operator to enter data in a field, and 
(3) providing an automatic enter operation as soon as the operator 
finishes processing of the field by moving the cursor out of the field. 



CHARACTERISTICS OF TYPE 2 SESSIONS 

Because a type 2 session is most commonly associated with a display and its 
keyboard, the session has some characteristics that do not apply to other 
session types. These characteristics are described below. 



DEVICE SHARING 

Device sharing is the use of a device (or medium) by more than one session. 
The SLU allows two sharing configurations: 

• Printer shared for display printout (copy) 

• Display shared between the SSCP-SLU and PLU-SLU sessions 

When a printer is shared between sessions, the contents of a screen can be 
copied to the printer. The allocation and scheduling of the printer is a 
local (controller) function. When a display is shared, concurrent sessions 
can be held between the SLU and a PLU and the SLU and its SSCP. The schedul- 
ing of messages to the display is an SLU function. In both cases, the sharing 
is not directly visible to the PLU. 

DISPLAY PRINTOUT [COPY) 

To provide a hard copy capability, the SLU must have - in addition to the 
display device - the use of a printer device. Although the printer device 
could be permanently allocated to one SLU, the more likely configuration is 
one in which one or more printer devices are shared among a group of SLUs. 




There is no forced print element positioning, for example, NL or FF, as a 
result of starting or ending a display printout. This does not preclude an 
automatic new line that is built into a printer operation, or an automatic 
form feed before or after a display printout. 

The request for a hard-copy printout of a display screen may be initiated 
from the host or by the operator: 

• Host initiated. The printout is initiated by the PLU sending a display 
printout request (write commands with WCC = Start Print). The display 
printout request must be sent either RQD or RQE,CD-EB. See "Error Condi- 
tions" for details on printer unavailable and other error conditions asso- 
ciated with the hard copy function. 

• Operator initiated. An operator-initiated printout is limited to the func- 
tion in which the operator at the display initiates a printout of the oper- 
ator's screen. The operator-i ni tiated printout should be handled locally 
(in the controller and not in the SLU). No PLU interaction is required or 
desired at the time of initiation. 
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SLU-PLU/SLU-SSCP DISPLAY SHARING 

An SLU simultaneously supports a session with a PLU and a session with the 
SSCP. This requires that the SLU resolve any presentation space contention 
that may occur between the SSCP-LU and LU-LU sessions. (See "Error 
Conditions" on page 42 for information on SLU-PLU/SLU-SSCP contention.) 



KEYBOARDLESS DISPLAY CONSIDERATIONS 

When an SLU receives a request with CD and the SLU is aware that nothing can 
be sent (for example* keyboardless display), LUSTAT X f 0Q02 f (no FM data to 
transmit) is sent to the PLU. 



PROTOCOLS 



Flip-Flop and Contention 



LU type 2 supports half-duplex flip-flop (HDX-FF) operation. Optionally, it 
may also support half-duplex contention operation. HDX-FF operation is 
required if the PLU must control or be aware of the display screen. 

Certain situations producing unpredictable results limit the usefulness of 
contention mode. An example is the support of the read commands. In an HDX 
flip-flop session, each read command must carry the CD indicator and the PLU 
must assume that the next chain it receives is the reply to the read command. 
In an HDX contention session, contention exists at the end of each chain. 
Therefore, unanticipated inputs can be expected from the PLU. This requires 
the SLU to be able to accept input from either the device or the PLU. In this 
mode, the PLU cannot be sure that data received after a read command is in 
fact the reply to the command. In fact, there i s no guarantee that the next 
SLU-to-PLU chain occurred after the previous PLU-to-SLU chain. Accurate 
correlation of input and output cannot be made. This mode requires the PLU to 
treat each flow independently even though the SLU does not. 

The remainder of this section is oriented to HDX-FF. 

Type 2 sessions use the concept of a formatted screen to reduce the amount of 
data that must be transferred from the display station to the PLU and vice 
versa. When the screen is formatted, only those fields defined as modified 
ares transferred in reply to a read modified operation. For traffic from the 
PLU to the display, the PLU may keep track of the format of the display and 
therefore reduce the amount of data that must be transferred to the display 
to alter the image. This approach can only be depended on for HDX-FF opera- 
tion. If contention is used, the PLU cannot directly control the screen and 
therefore cannot utilize this technique. 

A PLU may send two types of data to the SLU: (1) only an RH, used to control 
the direction of flow (for example, an RH with change direction or end brack- 
et specified), and (2) a 3270 command sequence with associated data when 
appropriate. For convenience in describing the control of the screen, two of 
the 3270 command sequences are named and defined: 

• Formatting Write. This consists of an Erase/Write command code followed 
by a WCC byte. Although the Erase/Write, Erase/Write Alternate, and Write 
Control Character can technically be considered a formatting write by an 
SLU, usually one or more SBA/SF attribute sequences &re also sent to 
provide the format. A formatting write assumes the display screen is 
logically blank and therefore transfers both the constant (nonvarying) part 
of the display image and those fields that may be modified by subsequent 
operation action. 
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* Formatted Write. This consists of a Write command code followed by a WCC 
byte and one or more 'SBA + data* sequences. The SBA(s) select which 
field(s) of the formatted screen the associated data applies to. 

The state of the screen as understood by the PLU determines the type of opera- 
tion that can be performed by the PLU in transferring data to the SLU to 
achieve minimal transmission. A formatted screen needs to receive only modi- 
fied fields from the PLU. An unformatted screen must receive the constants 
and literals that make up the display format as well as the modified fields. 
Except for forcing an unformatted screen following acceptance of BIND 
SESSION* the SLU enforces no screen states. 



EB/CD Relations to SLU States 



End Bracket (EB): An SLU that receives an EB usually executes the associated 
3270 command (other than RB/RM/RMA) and then goes into the contention state 
with the keyboard restored and the AID cleared. If the command does not 
explicitly restore the keyboard (and AID), it forces a restore. 

The exceptions to the above are the result of error conditions. On all the 
error conditions, bracket termination rule 1 applies. The SLU action for PSA 
and PSE error is described under "SLU Detected Errors" later in this chapter. 

An EB chain with a RB/RM/RMA command is considered an error condition. The 
rationale is that the EB is terminating a unit of work while the RB/RM/RMA 
command is extending the unit of work and they are thus in conflict. 

Change Direction (CD); The normal result of an SLU receiving a CD i n an RU 
chain containing a 3270 command (other than RB/RM/RMA) is for the SLU to 
execute the command and then go to send state. An RH-only chain with CD does 
the same except that there is no command to be executed. The keyboard is 
restored, and the AID is cleared only when explicitly done so by the command. 
The CD chain with RB/RM/RMA causes the SLU to execute the command, send data 
with CD, and return to the receive state. 

Exceptions to the above are the result of error conditions. (See "SLU 
Detected Errors" on page 46). 

Summary: Figure 3-1 summarizes the EB/CD/PSA relationship for an SLU in 
receive state. The purpose of the table is to define SLU action if a partic- 
ular RU chain is received. The appearance of a particular chain in the table 
does not mean the PLU should or will send it. 



Chaining and Segmenting 



Type 2 sessions support multiple-element RU chains and segmenting. For an 
HDX-FF session, RU chains from an SLU carry CD if the RH indicates FMD; an RU 
chain without CD is allowed if the RH indicates DFC. (For example, an RU 
chain containing user data is an FMD chain and an LUSTAT request is a DFC 
chai n. ) 

Only one 3270 command is allowed per RU chain. In addition, when a type 2 
half-session receives a chain element that contains a command, the command 
must be in the first byte of the RU. If required, the WCC must be the next 
byte following the command and must be in the same RU. There are no 
restrictions on sending RH-only RUs. 



ERROR CONDITIONS 



All errors are turned into exception requests by the element of the network 
that detects the error and sent forward (except for loss of path errors) to 
the destination LU. The destination LU then processes the exception requests 
and returns a negative response. 
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SLU Receives Chain with: 



SLU Action 



3270 Command 



EB CD 



PSA 
Pend? 



Exec 
CMD? 



Clr AID & 
Reset Kbd? 



Clr 
PSA? 



-RSP 
Sent 



S/R 
Stat< 



W,EW, EWA, EAU, Null 

RB,RM,RMA(l)chk 

RB,RM,RMA(l)-chk 

W,EW,EWA,EAU 

Null 

RB,RM,RMA(l)chk 

RB,RM,RMA(l)-chk 

W,EW, EWA, EAU, Null 

RB,RM,RMA 

W,EW,EWA,EAU 

Null 

RB,RM,RMA 

W,EW,EWA,EAU 

Null 

RB,RM,RMA 

W,EW,EWA,EAU 

Null 

RB,RM,RMA 



Y(3) 

N 

Y 

Y 
RM(3) 

N 

N 

YC3) 

Y 

Y 
RM(3) 

N 

Y 
N0P(3) 

N 

Y 
N0P(3) 

N 



Y 
N 
N 
C2) 
N 
N 
N 

(2) 

N 
(2) 

N 
N 

(2) 

N 

N 

(2) 

N 
N 



0829 

082AC4) 

0829 
084A 

082AC4) 
084A 



0829 
082A(4) 

0829 



C 

CE1 

S 
CE1 

S 
CE1 
CE1 

S 

s 

CE1 

S 
CE1 

R 

R 
CE1 
CE1 

R 
CE1 



Abbreviations used: 

W = Write 

EW = Erase Write 

EWA = Erase Write Alternate 

EAU = Erase All Unprotected 

RM = Read Modified 

RMA = Read Modified All 

RB = Read Buffer 



CD = Change Direction 

EB = End Bracket 

S = Send 

R = Receive 

C = Contention 

PSA = Presentation Space Altered 

CE1 = Contention ERP-1 



A hyphen indicates a 'not applicable 1 or 'don't care'. 

A write command (W, EW or EWA) with the WCC set to Start Print (SP) is defined as 
a request for a printout (hard copy) of the display. See "Display Printout" 
earlier in this chapter for details of the display printout function. The SLU 
action shown in the summary table applies, except that the command execution 
consists of first updating the screen if data accompanies the write command and 
then performing the printout of the display screen. 

When a keyboard is locked, certain 'control' keys may still be operable. For 
example, in the 3277, the reset key is operable in all SLU states whether or not 
the keyboard is locked. 

Note 1: An RB, RM or RMA received with EB is invalid and should not occur. In 
one option, the SLU checks for the condition; in the other, the SLU does not check 
for the condition. 

Note 2: Keyboard is restored and AID is cleared only if the command either is EAU 
or i s a W, EW or EWA with WCC = Keyboard Restore. 

Note 3: Null means an RU chain with only &n RH and therefore no command to 
execute. 

Note 4: The SLU may choose to handle the EW, EWA chain differently. If the SLU 
implementation is such that a formatting write sequence (EW, EWA usually followed 
by at least one SF sequence) can be recognized and if the results of prior opera- 
tor action are overwritten, then the SLU may clear the PSA, not send a negative 
response, and go to send state if CD is set. 



Figure 3-1. SLU action summary (receive state) 
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SENSE CODE SUMMARY 



All state errors (sequence numbers, chaining, brackets) may flow in both 
directions. Function management data (FMD) errors may be sent by the PLU. 
The following codes may be sent by the SLU. 

Request Reject - FM data (category code X f 08*): 

rce not available (printer) 
vention required (display) 

rce not available, LUSTAT forthcoming (printer) 
et race error 

et bid reject - no RTR forthcoming 
et bid reject - RTR forthcoming 
ver in transmit mode 
st not executable (display) 
e direction required 

ntation space alteration, request executed 
rast with X'084A») 
ntation space integrity lost 
sy (SLU resource already in use) 

vention required at LU subsidiary device (printer) 
st not executable because of LU subsidiary device (printer) 
mponent disconnected 

red FMDS synchronisation not supplied 
example, a request received WCC=SP,RQE,-CD) 
ntation space alteration, request not executed 
rast with X'082A') 
nent insufficient resource 

PS buffer resource required by Load PS is not available) 
enced local character set ID (LCID) not found 
nels loaded 
not loaded 
Partition state error 



0801 


Resou 


0802 


Inter 


0807 


Resou 


080B 


Brack' 


0813 


Brack 


0814 


Brack 


081B 


Recei 


081C 


Reque 


0829 


Chang 


082A 


Presei 




(cont 


082B 


Presei 


082D 


LU bu 


082E 


Inter 


082F 


Reque 


0831 


LU coi 


0843 


Requi 




(for 


084A 


Prese 




(cont 


084C 


Perma 




(the 


0863 


Refer 


0868 


No pa 


0869 


Panel 


0871 


Read 



Request Reject - BIND SESSION (Category code X'08'): 

080A Permission rejected - SSCP will not be notified 

(contrast with X'0845 f ) 
0821 Invalid session parameters (response to BIND) 
0833 Invalid parameter (with pointer and complemented byte) 
0845 Permission rejected - SSCP will be notified 

(contrast with X»080A f ) 

Request Errors (category code X T 10 f ): 

1001 RU data error 

1003 Function not supported 

Invalid 3270 command code 

Data following RB, RM, RMA or EAU command 
1005 Parameter error 

Invalid address follows SBA, or SBA or SF without parameters 
1007 Category not supported (for example, unsolicited FM 

data request on SSCP-LU session) 
1009 Format group not selected (no format group was selected 
before issuing a Present Absolute Format or Present 
Relative Format structured field) 

The SLU may send the following status codes in LUSTAT: 

0001 Component now avai lable (Notes 1 and 2) 

0002 No FM data to transmit (Note 3) 

0801 Component not available (for example, no resources 

configured) (Note 1) 
081C Component failure (Note 1) 
082B Component available, presentation space integrity 

lost (Notes 1 and 2) 
0831 Component disconnected (power off or some other 

disconnecting condition) (Note 1) 
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The format of LUSTAT is: 

Byte Value Definition 

X'04' Request code 

1-4 Status value and status extension field 

(two bytes each) 

X'0001' +'cc00* Component now available (0001) and 
component identification (ccOO). 

X' 0002' + ' rrrr' No FMD requests to send and reserved field. 

X'0801*+'cc00' Component not available (0801) and 
component identification (ccOO) 

X' 081C'+'cc00 ' Component failure - intervention required (081C) 
and component identification (ccOO) 

X' 082B'+ f ccOO ' Component available but presentation space 
integrity lost (082B) and component 
identification (ccOO) 

X' 0831'+' ccOO * Component disconnected (0831) and 
component identification (ccOO) 

Note 1 ; Values for 'cc' byte are: 

X'00 f = LU itself rather than a specific LU component. 

Otherwi se> 

Bit 0, set to 1 = Media other than LU 

Bits 1-3, LU component class: 

•Oil' Printer 
'101' Display 
All other values reserved. 

Bits 4-7, LU component device address. 

Note 2: LUSTAT X'0001' and LUSTAT X'082B' both indicate availability. The 
sense code the SLU uses depends on the presentation space state. If the pres- 
entation space is damaged or suspected of being damaged, LUSTAT X'082B' is 
used. LUSTAT X'0001' implies that the presentation space was not affected 
and that resumption, including the resending of a rejected request, will 
cause no presentation space problem. 

Note 3: LUSTAT X'0002' is used if the change direction indicator is received 
and the SLU is unable to send FM data; it is not used when the SLU is waiting 
for keyboard input. 

The RU chain containing LUSTAT cannot begin a bracket. 



CANCEL REQUEST 



A sendei — detected error occurs when the RU chain sender decides to abnormally 
terminate the current chain by sending the CANCEL request. This action is 
controlled by the chain sender and is independent of any action by the chain 
receiver. If the PLU receives such an error and the PLU is keeping track of 
screen states, it assumes the display format has been altered and replies 
with a formatting write. 
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The PLU may abort the chain it is sending by issuing CANCEL. The meaning of 
such an error is defined by the operating environment of the session. Since 
the SLU is free to transmit RUs to the display screen as they are received, 
receipt of CANCEL leaves the screen in an indeterminate state (that is, up to 
the last RU before CANCEL). The SLU is not required to update its current 
state. All type 2 sessions are bound with PLU recovery responsibility. 
Therefore, the SLU goes into receive state and awaits further PLU action. 
The PLU has two recovery options: 

In most situations, the PLU may retransmit precisely that chain it chose to 
abort. This results in the first part of the chain being reexecuted and the 
remainder of the chain being executed as originally intended. This would 
normally be chosen only if the chain was formatted write, and if the chain 
started with an explicit SBA order, and if there were no positioning refei — 
ences (such as PT) that were revised later in the chain. In short, the PLU 
must understand the chain content before attempting to retransmit. 

The PLU may transmit a formatting write. This rebuilds the screen format 
and leaves the SLU screen state as formatted. 

Any other action leaves the screen state in an unpredictable format. If the 
PLU is maintaining screen awareness and chooses to end the current bracket, 
the PLU must also exercise one of the above options or the PLU may not be able 
to interpret the first request of the new bracket (if one is begun by the 
SLU). 



PLU DETECTED ERRORS 



The PLU may reject an RU chain from the SLU for any valid reason. This 
includes so-called standard errors as well as FM unique errors (for example, 
"no such transaction code" from a transaction processing subsystem). When a 
chain is rejected, the PLU sends a negative response to the SLU and enters 
undefined state. The SLU responds by sending CANCEL if a chain is still in 
progress and enters receive state to await PLU action. The PLU then sends an 
error message to direct the next operator action. Since the PLU has entered 
an undefined state, this must be a formatting write if screen awareness is to 
be maintained. The error message may continue the current bracket by sending 
a CD or a -CD, or may end the current bracket by sending EB. 



SLU DETECTED ERRORS 



The SLU may detect errors in receiving an RU chain. The type of error deter- 
mines the state of the screen assumed by the PLU. Three different categories 
are identified: 

• State errors. These are sequence numbers, chain, and bracket protocol 
errors. The SLU sends the correct error response and enters purging chain 
state. Upon exit from the purging chain state, the SLU awaits PLU action 
unless bracket termination also occurred, in which case contention is 
entered. Normal error recovery action is for the PLU to terminate the 
current session by sending UNBIND SESSION. 

• Permanent device errors. This type of error is due to some hardware 
malfunction between the SLU and the display head (for example, buffer pari- 
ty error). When the error is detected, the SLU sends a negative response 
(X'OSIC 1 ), enters purging chain state, and, upon exit, enters receive or 
contention state as defined for state errors above. 

• Temporary device errors. When this type of error occurs, the SLU sends the 
appropriate negative response (for example, X f 0802 f intervention 
required). When the error condition is cleared, the appropriate LUSTAT is 
used to report correction of the error. If presentation space integrity 
has been lost, the SLU sends LUSTAT X , 082B". If presentation space integ- 
rity has not been lost, the SLU sends LUSTAT X'0001'. 
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The following defines the action for certain error conditions: 

1. Power off. An SLU may encounter a powei — off (display) situation either 
at BIND or during an established session. 

If a power-off condition exists at BIND, the SLU rejects the BIND SESSION 
request with a negative response of 0845 or 080A. The 0845 (permission 
rejected: SSCP will be notified), when sent to reject BIND SESSION, indi- 
cates that the SLU will notify the SSCP when another BIND SESSION can be 
accepted. The 080A (permission rejected: SSCP will not be notified), 
when sent to reject BIND SESSION, indicates that the LU will not notify 
the SSCP. 

If a power-off condition occurs during an established session, and the 
SLU is in the receive state, the SLU sends a negative response (X T 0831 f ) 
to indicate to the PLU that a power-off condition exists. If powei — off 
occurs while the SLU is in the send or contention state, an LUSTAT may be 
sent (also X T 0831 f ). When power has been restored, the SLU sends the 
appropriate LUSTAT status code to notify the PLU that the component is 
available: X'OOOl* or, if presentation space integrity has been lost, 
X , 082B'. The SSCP may also be notified at this time. 

2. Presentation space altered (PSA) (X f 082A f or X , 084A f ). To ensure PLU 
screen awareness/control when operati ng HDX-FF, the operator should not 
alter the screen while the SLU is in receive state. However, if the PLU 
restores the keyboard while the SLU is in receive state or if the display 
permits reset and enter capability regardless of SLU state, the screen 
can be altered. Type 2 sessions allows the reset and enter operation 
regardless of SLU state and records a presentation space altered (PSA) 
pending whenever the operator performs a reset and enter operation while 
the SLU is in receive state. However, the SLU is not required to record a 
PSA pending on an operator enter operation following an explicit PLU 
keyboard unlock (Write with WCC = keyboard restore) that leaves the SLU 
in the receive state. 

Whether the PSA pending results in a negative response depends on what 
the SLU subsequently receives from the PLU: 

All chains except an RH-only chain and RB/RM/RMA chain: The command is 
executed. A Write command with WCC = keyboard restore, and Erase/Write 
command with WCC = keyboard restore, EWA command with WCC = keyboard 
restore, or an EAU command clears the AID and restores the keyboard. 
If a PSA pending exists at the completion of the command execution, the 
SLU sends a negative response X'082A T , resets the PSA pending, and 
awaits PLU recovery action. 

RB/RM/RMA chain: If a PSA pending exists when the RB/RM/RMA chain is 
received, the command is not executed, and a negative response 084A is 
sent to notify the PLU of the PSA pending condition. This resets the 
PSA pending, and the SLU awaits PLU recovery action. If the data is 
required, another RB/RM/RMA chain must be sent. 

RH-only chain: SLU action depends on setting of EB/CD. (See "EB/CD 
Relation to SLU States" above for details.) Briefly, if a PSA pending 
exists when an RH-only chain with EB and with or without CD i s 
received, the SLU clears the PSA pending, negative response is not 
sent, and the SLU goes to the state appropriate for the EB/CD setting. 

In all the above cases, the normal PLU recovery is to send a formatting 
write (EW or EWA command - usually with one or more SFs) . Since the PSA 
pending is cleared once the negative response is sent, the SLU attempts 
to execute commands other than the formatting write. That is, the nega- 
tive response is not repeated unless the operator causes a new PSA pend- 
ing. 

3. Presentation space error (PSE) (X'OSZB*). This error condition is set as 
a result of detecting an error in the presentation space that is not 
locally recoverable; for example, a regeneration buffer parity error or 
operator action such as allowing SSCP use of the screen. When the screen 
size switching is allowed, presentation space integrity includes screen 
size as well as content. The X , 082B* error results from other than the 
operator action described under the X'082A t error. The X'082B' error is 
presumed to be transient and therefore recoverable by the PLU sending a 
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formatting write. However, if the error condition is not actually a 
transient but repeats, the SLU changes to negative response X'OSIC*. 

When the error is detected while the SLU is in receive state, it is 
reported via negative response X'082B'. If the error is detected while 
the SLU is in send or contention state, an LUSTAT is sent (also X , 082B'). 

If a locally initiated display printout fails and results in a damaged or 
questionable presentation space, the SLU sends negative response X , 082B' 
or the equivalent LUSTAT depending on the SLU state. 

Although the formatting write is the normal recovery for both PSA and 
PSE, note that the clearing of a PSA pending by an RH-only CD or EB chain 
is not applicable to PSE (X» 082B » ) . When an X'.OSZB'-is pending and an EW 
or EWA command is received, the SLU may reset the X*082B*; that is, not 
send the negative response or LUSTAT request. 

Display printout request ('Copy'). The display printout request is 
accomplished by sending a write command (Write, Erase/Write or 
Erase/Write Alternate) with WCC = Start Print (bit 4 of WCC) to the SLU. 
If the write command contains data, the display is updated before the 
printout operation. The display printout request must be sent as an RQD 
chain or an RQE, CD -EB' chain; Since the PLU is responsible for error 
recovery, the SLU does not have to check for RQE, CD, -EB chains. There- 
fore, if the PLU sends a display printout request as an RQE, -CD or RQE, 
CD, EB chain and follows with a screen update request, the SLU may 
attempt to update the screen before doing the print. If the SLU does 
check, an RQE, -CD or RQE, CD, EB i s rejected wi th negati ve response 
X'0843' (required FMDS synchronization not supplied). (The 'hard copy* 
function provided by the SLU does not utilize a copy control character.) 

a. Logi cal pri nter def i ni ti on. Several printers may be configured for 
an SLU's use for display printouts. A display printout request to 
the SLU could result in a display printout on any of the configured 
printers, depending on availability and the allocati on algori thm 
implemented. From a PLU view, however, there is only one logical 
printer regardless of how many physical printers are configured for 
the SLU. 

A logical printer is considered available if any of the physical 
printers configured for the SLU are able to immediately execute a 
display printout request. When none of the configured printers is 
available, the logical printer assumes the status of the most avail- 
able of the physical printers. The following are the unavailable 
categories listed in order of best to worst: 

Short-term busy. A di splay pri ntout request can be executed after 
"n" queued-up display printout requests are executed. The maximum 
delay is 30 minutes. Use of the printer by a session is not 
allowed. 

Intervention required condition exists. 

Allocated for session use or local use. 

Permanent error condition (or an intervention requi red si tuati on 
on an unattended printer). 

No logical printer configured. 

b. Logical printer not available. The SLU may reject a display printout 
request when the logical printer is not available. The following are 
the sense codes used; 

X f 082E l . The logical printer has an intervention required condi- 
tion, for example, out of paper, power off , cover interlock open, 
and so on. This code can be used only if the printer is attended. 
In general, attended means the condition will likely receive quick 
attention, such as when an operator is attending the printer or a 
mechanism exists to alert an operator. If the printer is unat- 
tended, the permanently unavailable code is used. 
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X'0807'. The logical printer is busy for an indeterminate period 
of time. This may range from a relatively short time when the 
printer is being used by another SLU for a display printout to many 
hours if all printers are assigned locally on a long term basis. 
(The SLU masks short term busy from the PLU by withholding negative 
response X'0807' . ) 

X'082F'. Effectively, the logical printer is permanently not 
available. For example, an unattended printer is out of paper. 

X'0801'. No printer configured. 

LUSTAT requirements. After sending negative response X'082E* or 
X'0807', an LUSTAT is sent when the condition clears. However, 
regardless of how many times the request is repeated, only one LUSTAT 
is sent when the condition does clear. Sending an LUSTAT X'0001' 
(source = printer) indicates to the PLU that a display printout 
request will find either an available or short term busy logical 
printer. Exceptions to the above are: 

The LUSTAT X'0001' (source = printer) reporting the clear of an 
X'082E' or X'0807' condition is not sent if: 

After sending negative response X*082E* or X'0807* the data traf- 
fic subtree is reset or the session terminated. 

After sending the logical negative response X'082E or X'0807* the 
printer develops a permanent error and is dropped from the 
configuration. An LUSTAT X'081C» or X'0801* (source = printer) 
is sent instead of LUSTAT X' 0001 * . 

The LUSTAT X'0001* (source = printer) does not indicate the PLU 
will necessarily find an available or short-term busy logical prin- 
ter if: 

After sending negative response X'082E» or X'0807*, the SLU 
receives any normal FM data request chain other than a display 
printout request chain. 

After sending LUSTAT X'0001' (source = printer), the logical 
printer develops an intervention required, permanent error, or a 
not-configured condition. The display printout request is 
rejected with the appropriate negative response; that is, 
X'082E', X'082F» or X'0801'. 

After sending negative response X'0807' or X*082E*, the SLU 
detects a nonprinter exception condition that causes a negative 
response. 

Generally, implementations do not allow session contention for a 
printer before honoring outstanding LUSTATs; that is, at least one 
physical printer is held after having sent the LUSTAT(s) so that the 
logical printer is available to execute copy requests. However, if 
as a result of an exception condition developing on the held printer, 
the logical printer status of *in session' results, then negative 
response X'0807' may also be sent. 

Recovery considerations. The negative responses X*082E', X'0807*, 
X'082F', and X'0801' indicate to the PLU that if the display printout 
request included screen update data, the screen update was accom- 
plished. If a display printout request (with update data) is sent 
again, it cannot be guaranteed that the screen will be unchanged. An 
example where the screen would be changed is if the request was a 
write to cursor, and the cursor position was altered later in the 
data stream. Therefore, following the receipt of an LUSTAT associ- 
ated with a previous negative response X'0807* or X'082E*, the PLU 
may do one of the following: 

Resend the display printout request (with update data) if the PLU 
is aware that the data stream is such that resending will not alter 
the screen. 

Resend the display printout request without the update data. 
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Rebuild the screen followed by display printout request with update 
data. 

e. PSA considerations. If a presentation-space-altered pending condi- 
tion exists when the copy of the display is transferred to the print- 
er* the printer operation completes and a negative response X'OSZA* 
is sent. This response indicates to the PLU that the display print- 
out was accomplished, but the display screen may have been altered. 
If the printout operation failed, the appropriate negative response 
would be sent rather than the X t 082A l response; however, the PSA 
condition remains. 

5. SLU-PLU/SLU-SSCP. When the SLU cannot accept a PLU request because the 
SSCP has the use of the screen, the request is rejected with negative 
response X , 082D , . After the SSCP-SLU session relinquishes the screen, 
the SLU returns an LUSTAT to indicate that the PLU has regained use of the 
screen. The type of LUSTAT returned depends on the SLU screen sharing 
implementation. If the SLU maintains screen integrity (such as storing a 
copy of the screen) during the SSCP interruption, LUSTAT X'0001 1 (compo- 
nent available) is sent. If the SLU does not maintain screen integrity, 
LUSTAT X , 082B', (component available, screen integrity lost) is sent. 
Note that when the SLU implementation does not maintain screen integrity, 
the LUSTAT is sent every time the SSCP-LU relinquishes the screen, 
regardless of whether or not a negative response X'082D* has been sent 
previously. The normal PLU recovery following LUSTAT X'082B* would be to 
rebuild the screen. 

6. SLU busy. The SLU may be unable to accept a request from the PLU because 
the SLU or its resources are already in use. An example would be if a 
local test routine was being exercised. A request received when the SLU 
is busy is rejected with negative response X'082D*. Negative response 
X , 082D' 1 requires that an LUSTAT be sent when the condition clears (see 
SLU-PLU/SLU-SSCP, item 5, for details). 

7. Keyboardless display considerations. When an SLU receives a request with 
CD and the SLU is aware that nothing can be sent (for example* a keyboard- 
less display), LUSTAT X»0002' is sent to the PLU. 



SAMPLE SEQUENCES 



The following examples illustrate basic data exchange sequences. The first 
example shows how a receiver alerts the sender when the receiver has data to 
send. The session is established and the partners are in brackets. The 
remaining examples show how the session partners (1) can get from contention 
between bracket state to in bracket state, and (2) can exchange data between 
them. The response is not shown unless it is a necessary part of the example. 
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EXAMPLE 1; Signal from PLU 

PLU SLU 

BC 

< 

< 

SIG Note 1 
> 

+ RSP 

< 



EC CD 

BC 



■> 



EC CD Note 2 
> 

SIG Note 3 
> 

+ RSP 
RH-only RU CD 



Note 1: The SLU receives SIG request while sending. The +RSP is returned to 
acknowledge receipt of the signal. The signal is effectively treated as no 
operation, and the SLU completes sending of the chain. The SLU always sends 
CD with the end of a data chain. 

Note 2: CD allows the SLU to send. The operator starts keying in data. 

Note 3: Before the operator initiates sending of data (for example, presses 
the ENTER key), the PLU sends SIG. The SLU sends +RSP to the signal, locks 
the keyboard, and sends CD. 



EXAMPLE 2: Bracket/Chain - SLU Initiated (Without Contention) 

PLU SLU 

BC BB Note 1 

< 

< 



EC CD 

< 

BCEC CD 
> 

BC 

< 

EC CD 

< 

BCEC EB Note 2 
> 

Note 1 : SLU initiates a bracket and sends an RU chain as a result, for 
example, of ENTER key depression. 

Note 2: After the required exchange of chains is completed, the PLU ends the 
unit of work by sending EB . (An SLU cannot send EB.) The chain with EB may 
contain data; for example, a write to the screen; or it may be an RH-only 
chai n . 
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EXAMPLE 3: Bracket/Chain - PLU Initiated (Without Contention) 

PLU SLU 

BID Note 1 

+ RSP 

< 

BC BB Note 2 
> 

. > 

EC CD 

> 

BCEC CD 
< 

BCEC EB 
> 

Note 1 ; PLU sends BID request to indicate intention to begin a bracket. 

Note 2: The positive response to BID allows the PLU to initiate the unit of 
work wi th BB. 



EXAMPLE 4: Bracket/Chain - PLU/SLU Contention 

PLU SLU 

BID Note 1 - Operator 

. > starts entering data 

-RSP X»081B* Note 2 

< 

BC BB Note 3 - Operator 

< initiates enter opei — 

< . __ 



BCEC EB Note 1 - Operator 
> starts entering data 

I BC BB 

< + Note 4 - Operator 

I initiates enter 

| BID operation 

-RSP X»0813' 

< : 

EC CD 

< 

BCEC EB 

— > 

Note 1 : The first keystroke puts the SLU in the send (but not transmitting) 
state. The SLU remains in BETB state. 

Note 2t The SLU will reject a BID (or BB with X T 081B' - receiver in transmit 
mode). 

Note 3: The operator initiates an enter operation ~ for example, presses the 
ENTER key. The SLU begins a bracket and transmits the entered data. 

Note 4: When the operator presses the ENTER key, the SLU goes to in bracket 
(INB) state. The SLU begins a bracket and starts sending data. The PLU has 
sent a BID (or BB) before the first chain element was received. The SLU 
rejects the BID (or BB) with X'GSIS', bracket bid reject. 
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BIND SESSION FORMAT FOR LU-LU SESSION TYPE 2 

This section defines valid bit settings for the BIND request. The BIND send- 
er selects the values to be used. Any value may be specified except those 
identified as not valid. All values listed must be supported by the BIND 
receiver unless the value is optional (identified by X in the Opt column) or 
not valid. 

Byte Bi ts Value Opt Pi scussi on 

0-7 X'31 f Identifies this RU as a BIND request. 

1 0-3 X'O' Specifies the format of the BIND RU. Only one format has been 

defined: format (zero). 

(1) 4-7 Type - denotes the type of BIND to be performed: 

X f f Not valid 
X'l» Nonnegotiable BIND 

FM (Function Management) Profile 

2 0-7 X'03 f FM profile 3 

The FM profile defines data flow control (DFC) protocols. (See 
SNA Reference Summary for highlights of the FM profile.) 



TS (Transmission Subsystem) Profile 



0-7 X»03» TS profile 3 



The TS profile defines transmission control (TO protocols. 
(See SNA Reference Summary for highlights of the TS profile.) 

FM Usage 

(4-7) See bytes 4 through 7 below. 

Primary Half-Session Protocols for FM Data 

Chaining Use: 

4 B'O' Primary half-session can send only single element chains. 
B'l 1 Primary half-session can send single or multiple element 
chai ns. 

Request Mode Selection: 

(4) 1 B'O* Immediate request mode is used. Only one definite response can 

be outstanding at a time. That response must be received before 
the primary half-session can send another RU. 
B*l" Not valid 

Chaining Responses: 

(4) 2-3 B f 00* Not valid 

B'Ol* Primary half-session can request only exception responses. 
B'lO" Primary half-session can request only definite response. 
B'll* Primary half-session can request definite or exception 
responses. 
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Byte Bi ts Value Opt Pi scussi on 

(4) 4-5 Reserved 

Compression Indicator: 

(4) 6 B'O' Primary half-session cannot send compressed data. 
B'l' Not valid 

Send End Bracket Indicator: 

(4) 7 B'O' Not valid 

B'l* Primary half-session can send EB. 

Secondary Half-Session Protocols for FM Data 

Chai ni ng Use: 

5 B'O' Not valid 

B'l' Secondary half-session can send single or multiple element 
chains. 

Request Mode Selection: 

(5) 1 B'O' Immediate request mode is used. Secondary half-session can 

issue a request for a single definite response. No further 
transmission is sent until the secondary half-session receives 
the requested response. 
B'l' Not valid 

Chaining Responses: 

(5) 2-3 B'00» Not valid 

B'01' Secondary half^session can request only exception responses. 
B'10' Secondary half-session can request only definite responses. 
B'll' Secondary half-session can request either definite or exception 
responses. 

(5) 4-5 Reserved 

Compression Indicator: 

(5) 6 B'O' Secondary half-session cannot send compressed data. 
B'l' Not valid 

Send End Bracket Indicator: 

(5) 7 B'O* Secondary half-session cannot send EB. 
B'l' Not valid 



Common Protocols for FM Data 

Reserved 

Primary half-session and secondary half-session cannot exchange 
FM headers. 
Not valid 

Brackets Usage and Reset State: 

(6) 2 B'O' Not valid 

B'l' Brackets are used and bracket state manager's reset state is 
BETB (between brackets). 



6 







(6) 


1 


B'O 
B'l 
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Byte Bi ts Value Opt Pi scussi on 

Bracket Termination Rule Selection: 

(6) 3 B'0 f Not valid 

B'l* Bracket termination rule 1 is used. 

Bracket termination is controlled by the form of response 
requested (definite or exception) for the chain containing 
(-*BB,EB). 

Alternate Code Selection: 

(6) 4 B'O* Alternate code set will not be used. 
B'l* X Alternate code set may be used. 

If byte 6, bit 4, is B*l f , the code selection indicator (CSI 
field of the RH (request header)) controls whether the alternate 
code i s to be used: 

CSI of = EBCDIC 
CSI of 1 = ASCII 

(6) 5-7 Reserved 

Normal-Flow Send and Receive Mode Selection: 

7 0-1 B^O' Not valid 
B»01» Not valid 

B'10' Half-duplex flip-flop 

Bracketed half-duplex flip-flop sessions require: 
Byte 4> bit 2 or 3 must be set to 1 (primary half-session chain- 
ing response). Byte 4, bit 7, or byte 5, bit 7 f or both must be 
set to 1 (send EB). Byte 5> bit 2 or 3 must be set to 1 (second- 
ary half-session chaining response). Byte 6» bit 2 must be set 
to 1 (bracketed session). Byte 7, bit and 1 must be set to 10 
(half-duplex flip-flop). Byte 7, bit 3 must be set to (sec- 
ondary half-session is the contention winner). Byte 7> bit 7 
must be set to (reset state is receive for primary and send 
for secondary) . 

B'll' Reserved 

Recovery Responsibility: 

(7) 2 B'O* The contention loser is responsible for any error recovery 

attempts for the session. 
B»l f Not valid 

Contention Winner/Loser: 

(7) 3 B f f Secondary LU is contention winner and primary LU is contention 

loser. 
B f l» Not valid 

(7) 4-6 Reserved 

Half-Duplex Flip-Flop (HDX-FF) Reset States: 

(7) 7 Reserved 



TS Usaga 

(8-13) See bytes 8 through 13 below. 
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Byte Bi ts Value Opt Pi scussi on 

Staging Indicator and Pacing Count for Secondary CPMGR (con- 
nection point manager) to Primary CPMGR normal flow: 

8 B f 0' Pacing in this direction occurs in one stage. 

B*l" Pacing in this direction occurs in two stages. 

Note: The meanings of and 1 are reversed from the staging 
indicator for primary CPMGR to secondary CPMGR (see byte 12). 

(8) 1 Reserved 

(8) 2-7 B'nnnnnn' Secondary CPMGR send pacing count. A value of 000000 means no 

pacing of requests flowing from the secondary. 

9 0-1 Reserved 

(9) 2-7 B'nnnnnn' Secondary CPMGR receive pacing count. A value of 000000 causes 

the boundary function to substitute the value set by a system 
definition pacing parameter ( i f the system definition includes 
such a parameter) before it sends the BIND RU on to the second- 
ary LU. A value of 000000 received at the secondary LU is 
interpreted to mean no pacing of requests flowing to the second- 
ary LU. 

10 X'ab' X Maximum RU size sent on the normal flow by the secondary 

half-session. This value represents the largest RU that can be 
sent. It is expressed as a mantissa and an exponent value of 2 
by which the mantissa is multiplied. 

X*85' When the mantissa is 8 and the exponent is 5 (X'85'), the RU 
size is 256 bytes (8 x 2 5 ). 

B'On...' When bit is set to zero, no maximum is specified and the 

remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab*. See Appendix B for these values. 

11 X'ab* X Maximum RU size sent on the normal flow by the primary 

half-session. Thi s value represents the largest RU that can be 
sent by the primary half-session and is specified in the same 
format as the secondary half-session (byte 10). 

X'85' When the mantissa is 8 and the exponent is 5 (X'85'), the RU 
size is 256 bytes (8 x 2 5 ). 

B'On...* When bit is set to zero, no maximum is specified and the 

remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab'. 



Staging Indicator and Pacing Count for Primary CPMGR ( 
nection point manager) to Secondary CPMGR normal flow: 



con- 



12 B'0' Pacing in this direction occurs in two stages. 
B'l' Pacing in this direction occurs in one stage. 

Note: The meanings of and 1 are reversed from the staging 
indicator for secondary CPMGR to primary CPMGR (see byte 8). 

(12) 1 Reserved 

(12) 2-7 B'nnnnnn' Primary CPMGR send pacing count. A value of 000000 causes the 

value set by a system definition pacing parameter (if the system 
definition includes such a parameter) to be assumed for the 
session. If this is also 000000, it means no pacing of requests 
flowing from the primary. 

For single-stage pacing in the primary-to-secondary direction, 
this field is redundant with, and will indicate the same value 
as, the secondary CPMGR receive pacing count (see byte 9, bits 
2~7 above) . 
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Byte Bi ts Value Opt Pi scussi on 

13 0-1 Reserved 

(13) 2-7 B'nnnnnn 1 Primary CPMGR receive pacing count. A value of 000000 means no 

pacing of requests that flow to the primary. For single-stage 
pacing in the secondary-to-primary direction, this field is 
redundant with, and will indicate the same value as, the second- 
ary CPMGR send pacing count (see byte 8, bits 2-7 above). 



PS Profile 

(14-25) See bytes 14 through 25 below. 

14 B'0' PS usage field format is the basic format 

B'l» Reserved 

(14) 1-7 B'OOOOOIO* LU-LU session type 2 



PS Usage 










15 


B» 
B» 


0» 
1' 


X 


Query not supported 
Query supported 


1-7 








Reserved 


16-19 








Reserved 
Screen-Size Control 



Use byte 24 to specify a 480- or 1920-character screen size for 
the base set of the SNA 3270 data stream. Use bytes 20-24 to 
specify screen sizes for implementations that use more than the 
base set of the SNA 3270 data stream. (See Note 1.) 

20 0-7 X Default screen size: rows. This is the number of rows in the 

screen, stated in binary. Permissible values are from 1 to 255. 

21 0-7 X Default screen size: columns. This is the number of columns in 

the screen, stated in binary. Permissible values are from 1 to 
255. 

22 0-7 X Alternate screen size: rows. This is the number of rows in the 

screen, stated in binary. Permissible values are from 1 to 255. 

23 0-7 X Alternate screen size: columns. This is the number of columns 

in the screen, stated in binary. Permissible values are from 1 
to 255. 

24 Reserved 

(24) 1-7 Screen size (see Note 1) 

0000000 Not specified 

0000001 X 12 rows by 40 columns (480 characters). (See Note 2.) 

0000010 X 24 rows by 80 columns (1920 characters). (See Note 2.) 

0000011 X Unspecified screen size. (See Note 1.) 

1111110 X Static size specified by bytes 20 and 21. (See Note 3.) 

1111111 X Default size specified by bytes 20 and 21, and alternate size 

specified by bytes 22 and 23. (See Note 4.) 

All other values reserved. 

25 Reserved 
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Bvte Bits Value Opt Pi scussi on 
Cryptography Options 



26 0-1 



(26) 2-3 



(26) 4-7 



27 0-1 



(27) 2-4 
(27) 5-7 



28-k 



B'00» 
B'01« 



10 
11 



00 
01 



B'10» 
B»ll f 



X'0» 
X f 9' 

B'OO' 



Private cryptography options: 

No private cryptography supported. 

Private cryptography supported. The session cryptography key 

and cryptography protocols are privately supplied by the end 

user. 

Reserved 

Reserved 



Session-level cryptography options: 



X No session-level cryptography supported. 

X Session-level selective cryptography supported. All cryptogra- 
phy key management is supported by the SSCP and LU; exchange 
(using +RSP to BIND) and verification (using CRV) of the cryp- 
tography session-seed value are supported by the LUs for the 
session. All FM data requests with EDI (enciphered data indica- 
tor) on are enciphered/deciphered. 
Reserved 

X Session-level mandatory cryptography supported; same as 
session-level selective cryptography except all FM data 
requests are enciphered/deciphered. 

Session-level cryptography options field length: 

X No session-level cryptography specified. The cryptography 

option fields (bytes 27-k) are omitted. 
X Session-level cryptography specified. Additional options 

follow in the next nine bytes. 

Session cryptography key enci pherment mode; 

X Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key using a seed value of zero (only 
value defined). 

Reserved 

Cryptography cipher method: 

B f 000* X Block chaining with seed and cipher text feedback* using the 

Data Encryption Standard (DES) algorithm (only value defined). 

X Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key; an eight-byte value that* when 
deciphered, yields the session cryptography key used for enci- 
phering and deciphering FM data requests. 



Names and End User Data 



k+1 





X'00' 






X'nn' 


X 


k+2-m 




X 


m+1 


X'00» 






X'nn* 


X 



Length of BIND sender's (or PLU) name in field k+2-m. 

Field k+2-m does not exist. 

Field k+2-m contains the number of bytes specified (cannot 

exceed X'08 f ) . 

BIND sender's (or PLU) name. 

Length of user data in field m+2-n. 

Field m+2-n does not exist. 

Field m+2-n contains the number of bytes specified. 
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Byte Bi ts Value Opt Pi scussi on 

m+2-n X User data. 

m+2 X User data key. 

X*00» X Structured subfields follow. 

-X'OO' X First byte of unstructured user data. 

Note; The unstructured user data continues in m+3 and goes to 
byte n. For information on structured subfields, see the BIND 
information in SNA Format and Protocol Reference Manual: Archi- 
tecture Logic. 

n+1 Length of user request correlation field. 

X'OO* Field n+2-p does not exist. 

X'nn' X Field n+2-p contains the number of bytes specified. 

n+2-p X User request correlation field. 

p+l Length of BIND receiver's (or SLU) name in field p+2-r. 

X'OO' Field p+2-r does not exist. 

X'nn' X Field p+2-r contains the number of bytes specified (cannot 

exceedX ! 08'). 

p+2-r X BIND receiver's (or SLU) name. 



Notes 

The following notes apply to the BIND SESSION request: 

Note 1 . Screen sizes can be specified using byte 24, or byte 24 can refer to 
the screen sizes defined in bytes 20-21, and, as required, bytes 22-23. If 
the base set of the SNA 3270 data stream is used, byte 24, bits 1-7, may spec- 
ify only B'0000000', B'0000001', or B'0000010'. The B'0000000' value permits 
either a 480 or 1920 screen size. If any functions above the base set of the 
SNA 3270 data stream are used, byte 24 may specify any of the defined values. 

If byte 24, bits 1-7 specify B'0000011', the default screen size is 1920 
characters (24 x 80) and the alternate screen size is specified in the Query 
Reply (Usable Area) structured field. 

If the data being loaded in the display buffer exceeds the designated screen 
limit, the remainder of the data is wrapped, that is, loaded starting at the 
first buffer position. With one exception, the display screen wraps at the 
value(s) specified in BIND regardless of the actual size of the screen. The 
exception is the byte 24, bits 1-7, value of B'0000000'; the screen wraps at 
the end of the actual screen size (480 or 1920). 

Note 2: The screen size is fixed for the duration of the session when this 
mode is selected. When in this mode, an Erase/Write Alternate command may be 
rejected with negative response X'1003'. 

Note 3: If byte 24, bits 1-7, contain B'1111110', the screen size specified 
in bytes 20-21 is static. Bytes 22-23 are not used. When in this mode, an 
Erase/Write Alternate command may be rejected with negative response X'1003'. 
Valid row and column parameters for default bytes 20-21 can be found in 
implementation literature. The product of the number of rows (byte 20) and 
columns (byte 21) must not exceed 4096 for the base set of the SNA 3270 data 
stream (upper limit of order stream addressing), and 65536 when the base set 
is extended with additional functions. 

Note 4: An alternate screen size may be specified if byte 24, bits 1-7, 
contain B'lllllll' (dynamic screen size switching within a session). 

The BIND operation establishes both default (bytes 20-21) and alternate 
(bytes 22-23) screen sizes to be used within a session. It initializes the 
unit by setting it in the default screen size mode. 
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An Erase/Write Alternate command changes the screen size from default to 
alternate. An Erase/Write command or depression of the CLEAR key changes the 
screen size from alternate to default. 

Valid row and column parameters for default bytes 20-21 and alternate bytes 
22-23 can be found in implementation literature. The product of the number 
of rows and columns must not exceed 4096 for the base set of the SNA 3270 data 
stream (upper limit of order stream addressing), and 65536 when the base set 
is extended with additional functions. 
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PART 1 CHAPTER 4. LU-LU SESSION TYPE 3 



Type 3 LU-LU sessions support data communication between an application 
program and a single printer (without a keyboard) using the SNA 3270 data 
stream. Type 3 sessions allow users to migrate existing customei — written 
3270 application programs into an SNA network. 

Type 3 sessions associate a single device with the SLU. The logical device 
within the SLU is visible to the PLU. Consistency is maintained between a 
given physical device and the LU for the duration of a unit of work* for exam- 
ple; a bracket. The same physical device is always associated with a partic- 
ular SLU. The device may be dedicated permanently or dedicated only for the 
duration of a bracket or a session: however* it is always the same physical 
device. Except where otherwise noted* the description assumes a dedicated 
pri nter . 

Products that use type 3 sessions use the SNA 3270 data stream. The data 
stream is introduced in Part 2 Chapter 2. (For details of the data stream* 
see 3270 Data Stream Programmer's Reference.) When the following options are 
implemented* they must conform to the protocols of the SNA 3270 data stream: 

1. Buffer size. The SLU supports either a 480- or 1920-character print 
buffer size. This applies when the physical buffer size is larger than 
the required basic 480 (12x40) or 1920 (24x80) size. When the buffer is 
physically larger* the buffer wraps at the 480 or 1920 point* depending 
on the value specified in byte 24 of the BIND SESSION request. 

The SLU may support larger and smaller buffer sizes* up to a 4096-byte 
addressing limit with 14-bit addressing* and up to 65*536 with 16-bit 
addressi ng. 

2. Buffer size switching. In addition to the basic and extended buffer 
sizes described above, the SLU may provide dynamic buffer size switching. 
The buffer size may be switched between two values* specified in BIND 
SESSION* by the Erase/Write and the Erase/Write Alternate commands. The 
Erase/Write command selects the default size while the Erase/Write Altei — 
nate command selects the alternate size. The buffer size is initialized 
to the default size. 

The above options can be implemented using a mandatory set of data stream 
functions. The SNA 3270 data stream has options that provide additional 
character set* color* and highlighting functions for LU-LU session type 3 
implementations. The application program can control the character set to be 
used for a field or character* as well as control the characters color and any 
emphasis that it should have (such as underlining). The following functions 
are specifically excluded: 

Multiple partitions 

Scrolli ng 

Field validation 

Part 2 Chapter 2 shows which data stream functions are not applicable to type 
3 sessions. 



CHARACTERISTICS OF TYPE 3 SESSIONS 

The profiles that define type 3 sessions differ slightly from those that 
define type 1 and 2 sessions. These differences are discussed here. 
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DEVICE SHARING 



In addition to providing a dedi cated pri nter configuration, the SLU allows 
sharing of the printer for local use; for example, for type 2 display print- 
outs as well as for type 3 session use. The use for type 2 printouts may be on 
a between-sessi on or between-bracket basis. If a request should arrive from 
the PLU while the printer is in use, the SLU rejects it with a negative 
response (X'OSl^*) followed by RTR (ready to receive) when the printer is 
avai lable. 

The allocation and scheduling of the shared device(s) is a local (controller) 
function. The sharing is not directly visible to the PLU and may not be visi- 
ble to the SLU. 

The SLU does not provide any forced print element positioning (for example, 
NL or FF as a result of an EB or BB), but an implementation optionally may do 
so. 

When a printer is configured for sharing between brackets, the PLU must 
assume that both the print buffer and print element positioning has changed 
between brackets. The SLU does not inform the PLU whether the printer was 
used. The same applies to the between-sessi on interval when sharing between 
sessions is configured. 



PROTOCOLS 



Chaining and Segmenting 



The SLU receives multiple element chains. Support of segmenting is optional. 
The SLU does not send FM data chains. 

Only one 3270 command is allowed per RU chain. In addition, when an SLU 
receives a chain element that contains a command, the command must be the 
first byte of the RU; the WCC must be the next byte following the command and 
must be in the same RU. 

There are no restrictions on sending RH-only RUs to an SLU. 



Half-Duplex FliP-Flop 



The SLU operates only in HDX-FF mode. It always sends LUSTAT X f 0002* with CD 
to return the flow immediately whenever the PLU sends CD with any request. 



RQD and Start Print 



All write commands with the start print bit set on in the WCC must be sent 
either RQD (request definite response) or RQE,CD (request exception response, 
change direction). The PLU is responsible for enforcement. If the SLU 
elects to check, however, a request with WCC = start-pri nt ,RQE,-CD is 
rejected with negative response X'0843' (required FMDS synchronization not 
provi ded) . 

A positive response is not sent for requests with WCC = start-pri nt, RQD until 
the print operation completes. 

If the start print bit is not set on in the WCC, the SLU allows sending the 
chain RQE,-CD. 
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Reading the Buffer 



A type 3 printer accepts the same commands as a type 2 display except that 
Read, Read Modified, and Read Modified All are not accepted. 

Because multiple partitions are not allowed, a Read Partition structured 
field is invalid for any use other than to perform a Query operation. The 
Read Modified command is accepted to retry a query operation. (The content 
of the character buffer cannot be read.) 



ERROR CONDITIONS 



All errors are turned into exception requests by the element of the network 
that detects the error and sent forward (except for the loss of path errors) 
to the destination LU. The LU then processes the exception request and 
returns a negative response. 



SENSE CODE SUMMARY 



All state errors (sequence numbers, chaining, brackets) may flow in both 
directions. Function management data (FMD) errors may be sent by the PLU 
The following codes may be sent by the SLU. 

Request Reject - FM data (category code X'08'): 

0801 Resource not available (printer not configured) 

0802 Intervention required 

0814 Bracket bid reject - RTR forthcoming 

081B Receiver in transmit mode 

081C Request not executable 

082B Presentation space integrity lost 

082D LU busy (SLU resource already in use) 

0831 LU component disconnected 

0843 Required FNDS synchronization not supplied 

(for example, a request received WCC=SP, RQE,-CD) 
084C Permanent insufficient resource 

(the PS buffer resource required by Load PS 

is not available) 
0863 Referenced local character set ID (LCID) not found 
087F Query Reply parameter changed - RU chain processed 
0880 Query Reply parameter changed - RU chain not processed 

Request Reject - BIND SESSION (category code X f 08'): 

080A Permission rejected - SSCP will not be notified 

(contrast with X'G84A f ) 
0821 Invalid session parameters 
0845 Permission rejected - SSCP will be notified 

(contrast with X'080A») 

Request Error: 10XX 

1001 RU data error 

1003 Function not supported 

Invalid 3270 command code 

Data following EAU command 

Attempt to read character buffer 
1005 Parameter error 

1007 Category not supported (for example, FM data request 
received on SSCP-LU session) 
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The SLU may send the following status codes in LUSTAT: 

0001 Component now available (notes 1 and 2) 

0002 No FM data to transmit 

0801 Component not available (for example* no resources 

configured (note 1) 
0S1C Component failure (note 1) 
082B Component available, presentation space integrity 

lost (notes 1 and 2) 
0831 Component disconnected (power off or some other 

disconnecting condition) (note 1) 

The format of LUSTAT is: 

Byte Value Definition 

X'04* Request code 

1-4 Status value and status extension field 

(two bytes each) 

X'0001 '+'0000* Component now available (0001) and 

component identification (ccOO) (see note) 

X" 0002'+' rrrr * No FMD requests to send and reserved field. 

X f OSOl'+'ccOO 1 Component not available (0801) and 
component identification (ccOO) 

X* 031C + ' ccOO * Component failure - intervention required (081C) 
and component identification (ccOO) 

X f 082B f +*cc00 ' Component available, but presentation space 
integrity lost (082B) and component 
identification (ccOO) 

X* 0831 , + , ccOO ' Component disconnected (0831) and 
component identification (ccOO) 

Note 1: Values for 'cc* byte are: 

X'OO* = LU itself rather than a specific LU component. 

Otherwi se, 

Bit 0, set to 1 = media other than LU 

Bits 1-3, LU component class: 

'Oil* Printer 
»101 f Display 
All other values reserved. 

Bits 4-7, LU component device address. 

Note 2: LUSTAT X'0001» and LUSTAT X» 082B* both indicate availability. The 
sense code the SLU uses depends on the presentation space state. If the pres- 
entation space is damaged or suspect of being damaged, LUSTAT X f 082B* is 
used. LUSTAT X'OOOl* implies that the presentation space was not affected 
and that resumption, including resending a rejected request, will cause no 
presentation space problem. 
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SLU DETECTED ERRORS 



The SLU may detect errors in receiving an RU chain. The type of error 
detected determines the state of the buffer to be assumed by the PLU. Four 
different categories are identified: 

• State, sequence-number, chain, and bracket-protocol errors. The SLU sends 
the correct error response and enters purging chain state. Upon exit from 
the purging chain state, the SLU goes to receive state unless bracket 
termination also occurred (in which case contention is entered). Normal 
recovery action is for the PLU to terminate the current session by sending 
UNBIND SESSION. 

• Permanent device errors. This type of error is due to some hardware 
malfunction between the SLU and the printer (for example, buffer parity 
error). When the error is detected, the SLU sends a negative response 
(X'081C f ), enters purging chain state, and, upon exit, enters receive or 
contention state as defined for state errors. 

• Temporary device errors. When this type of error occurs, the SLU sends a 
negative response (X'0802 T intervention required). When the error condi- 
tion is cleared, the appropriate LUSTAT is used to report correction of the 
error. If presentation space integrity has been lost, the SLU sends LUSTAT 
X'082B'. If presentation space integrity has not been lost, the SLU sends 
LUSTAT X'0001*, component available. 

• Power off. An SLU may encounter a printer-off situation either at BIND or 
during a session. 

If a powei — off condition exists at BIND, the SLU rejects the BIND with either 
negative response X f 0845' or X'080A*. The X f 0845 f , when sent to reject a 
BIND, indicates that the SLU will notify the SSCP when a BIND can be accepted. 
The X'080A', when sent to reject a BIND, indicates that the SLU will not noti- 
fy the SSCP when a BIND can be accepted. 

If a powei — off condition occurs during a session, and the SLU is in the 
receive state, the SLU sends negative response X'OSSl* to indicate to the PLU 
that a powei — off condition exists. If powei — off occurs while the SLU is in 
the send or contention state, an LUSTAT may be sent (same error code). When 
power has been restored, the SLU sends the appropriate LUSTAT status code to 
notify the PLU that the component is available: X'0001* or, if presentation 
space integrity has been lost, X'OSZB', 
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BIND SESSION FORMAT FOR LU-LU SESSION TYPE 3 

This section defines valid bit settings for the BIND request. The BIND send- 
er selects the values to be used. Any value may be specified except those 
identified as not valid. All values listed must be supported by the BIND 
receiver unless the value is optional (identified by X i n the Opt column) or 
not valid. 

Byte Bi ts Value Opt Pi scussi on 

0-7 X^l* Identifies this RU as a BIND request. 

1 0-3 X*0 f Specifies the format of the BIND RU. Only one format has been 

defined: format (zero). 

(1) 4-7 Type - denotes the type of BIND to be performed: 

X'0 f Not valid 
X'l* Nonnegotiable BIND 

FM (Function Management) Profile 

2 0-7 X'03* FM profile 3 

The FM profile defines data flow control (DFC) protocols. (See 
SNA Reference Summary for highlights of the FM profile.) 

TS (Transmission Subsystem) Profile 

3 0-7 X'03' TS profile 3 

The TS profile defines transmission control (TO protocols. 
(See SNA Reference Summary for highlights of the TS profile.) 



FM Usage 

(4-7) See bytes 4 through 7 below 

Primary Half -Session Protocols for FM Data 

Chai ning Use: 



B«0 
B'l 



Primary half-session can send only single element chains 
Primary half-session can send single or multiple element 



chai ns. 

Request Mode Selection: 

(4) 1 B'O" Immediate request mode is used. Only one definite response can 

be outstanding at a time. That response must be received before 
the primary half-session can send another RU. 
B'l* Not valid 

Chaining Responses: 

(4) 2-3 B'OO 1 Not valid 

B'01* Primary half-session can request only exception-only responses. 
B'10* Primary half-session can request only definite response. 
B'll* Primary half-session can request definite or exception-only 
responses. 
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Byte Bi ts Value Opt Pi scussi on 

(4) 4-5 Reserved 

Compression Indicator: 

(4) 6 B'O' Primary half-session cannot send compressed data. 
B*l f Not valid 

Send End Bracket Indicator: 

(4) 7 B'O' Not valid 

B'l* Primary half-session can send EB. 

Secondary Half-Session Protocols for FM Data 

Chai ni ng Use: 

5 B'O' X Secondary half-session can send only single element chains. 
B'l' Secondary half-session can send single or multiple element 
chai ns. 

Request Mode Selection: 

(5) 1 B'O' Immediate request mode is used. Secondary half-session can 

issue a request for a single definite response. No further 
transmission is sent until the secondary half-session receives 
the requested response. 
B'l' Not valid 

Chaining Responses: 

(5) 2-3 B'OO' Not valid 

B'01' Secondary half-session can request only exception responses. 
B'10 f Secondary half-session can request only definite responses. 
B'll' Secondary half-session can request either definite or exception 
responses. 

(5) 4-5 Reserved 

Compression Indicator: 

(5) 6 B'O' Secondary half-session cannot send compressed data. 
B'l' Not valid 

Send End Bracket Indicator: 

(5) 7 B'O' Secondary half-session cannot send EB . 
B'l' Not valid 



Common Protocols for FM Data 

6 Reserved 

(6) 1 B'O' Primary half-session and secondary half-session cannot exchange 

FM headers. 
B»l f Not valid 

Brackets Usage and Reset State: 

(6) 2 B'O' Not valid 

B'l' Brackets are used and bracket state manager's reset state is 
BETB (between brackets). 

Bracket Termination Rule Selection: 

(6) 3 B'O' Not valid 
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Byte Bi ts Value Opt Pi scussi on 

B*l f Bracket termination rule 1 is used. Bracket termination is 

controlled by the form of response requested (definite or excep- 
tion) for the chain containing (-BB>EB). 

Alternate Code Selection: 

(6) 4 B'O* Alternate code set will not be used. 
B'l* X Alternate code set may be used. 

If byte 6, bit 4, i s B ' 1 ' , the code selection indicator (CSI 
field of the RH (request header)) controls whether the alternate 
code is to be used: 

CSI of = EBCDIC 
CSI of 1 = ASCII 

(6) 5-7 Reserved 

Normal-Flow Send and Receive Mode Selection: 

7 0-1 B'OO* Not valid 
B'Ol* Not valid 

B'lO 1 Half-duplex flip-flop 

Bracketed half-duplex flip-flop sessions require: 

Byte 4> bit 2 or 3 must be set to 1 (primary half-session chain- 

i ng response) . 

Byte 4, bit 7> or byte 5, bit 7, or both must be set to 1 (send 

EB). Byte 5, bit 2 or 3 must be set to 1 (secondary half-session 

chaining response). Byte 6, bit 2 must be set to 1 (bracketed 

session). Byte 7* bit 7 must be set to (reset state is Receive 

for primary and Send for secondary). 

B , ll* Reserved 

Recovery Responsibility: 

(7) 2 B'O* The contention loser is responsible for any error recovery 

attempts for the session. 
B»l* Not valid 

Contention Winner/Loser: 

(7) 3 B*0* Secondary LU is contention winner and primary LU is contention 

loser. 
B»l» Not valid 

(7) 4-6 Reserved 

Half-Duplex Flip-Flop (HDX-FF) Reset States: 

(7) 7 Reserved 



TS Usage 

(8-13) See bytes 8 through 13 below. 

Staging Indicator and Pacing Count for Secondary CPMGR (con- 
nection point manager) to Primary CPMGR normal flow: 

8 Reserved 

9 0-1 Reserved 

(9) 2-7 B'nnnnnn* Secondary CPMGR receive pacing count. A value of 000000 causes 

the boundary function to substitute the value set by a system 
def i ni ti on pacing parameter (if the system definition includes 
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Byte Bi ts Value Opt Pi scussi on 



10 
11 



such a parameter) before it sends the BIND RU on to the second- 
ary LU. A value of 000000 received at the secondary LU is 
interpreted to mean no pacing of requests flowing to the second- 
ary LU. 

Reserved 

X'ab* X Maximum RU size sent on the normal flow by the primary 

half-session. This value represents the largest RU that can be 

sent. 

It is expressed as a mantissa and an exponent value of 2 by 

which the mantissa is multiplied. 

X'85' When the mantissa is 8 and the exponent is 5 (X'SS*), the RU 
size is 256 bytes (8 x 2 5 ). 

B f 0n... f When bit is set to zero, no maximum is specified and the 

remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab*. See Appendix B for these values. 



12 



(12) 1 
C12) 2-7 



B*0 
B'l 



B'nnnnnn 



Staging Indicator and Pacing Count for Primary CPMGR (con- 
nection point manager) to Secondary CPMGR normal flow: 

Pacing in this direction occurs in two stages. 
Pacing in this direction occurs in one stage. 

Note: The meanings of and 1 are reversed from the staging 
indicator for secondary CPMGR to primary CPMGR (see byte 8). 

Reserved 

Primary CPMGR send pacing count. A value of 000000 causes the 
value set by a system definition pacing parameter (if the system 
definition includes such a parameter) to be assumed for the 
session. If this is also 000000, it means no pacing of requests 
that flow from the primary. 

For single-stage pacing in the primary-to-secondary direction, 
this field is redundant with, and will indicate the same value 
as, the secondary CPMGR receive pacing count (see byte 9, bits 
2~7 above) . 



13 



Reserved 



PS Prof i le 



(14-25) 
14 



B'O 

B'l 



See bytes 14 through 25 below. 

PS usage field format is the basic format. 
Reserved 



(14) 1-7 B'OOOOOll' LU-LU session type 3 



15 


B» 
B* 


f 
1' 


X 


Query not supported 
Query supported 


1-7 








Reserved 


16-19 








Reserved 

Buffei — Size Control: 
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Byte Bi ts Value Opt Pi scussi on 

Use byte 24 to specify a 480- or 1920-character print buffer 
size for the SNA 3270 data stream. Use bytes 20-24 to specify 
print buffer sizes for all uses of the extended SNA 3270 data 
stream (see Note 1). 

Buffer sizes are specified by row and column to be consistent 
with buffer sizes in LU type 2. The row and column values have 
no significance in LU type 3 other than their product defines 
the buffer's wrap point. 

20 0-7 X Default buffer size: rows. This is the number of rows in the 

buffer, stated in binary. Permissible values are from 1 to 255, 

21 0-7 X Default buffer size: columns. This is the number of columns in 

the buffer* stated in binary. Permissible values are from 1 to 
255. 

22 0-7 X Alternate buffer size: rows. This is the number of rows in the 

buffer* stated in binary. Permissible values are from 1 to 255 

23 0-7 X Alternate buffer size: columns. This is the number of columns 

in the buffer* stated in binary. Permissible values are from 1 
to 255. 

24 Reserved 

(24) 1-7 Buffer size (see Note 1) 

0000000 Not ^specified 

0000001 X 12 rows by 40 columns (480 characters) (see Note 2) 
0000010 X 24 rows by 80 columns (1920 characters) ( see Note 2) 

1111110 X Static size specified by bytes 20 and 21 (see Note 3). 

1111111 X Default size specified by bytes 20 and 21* and alternate size 

specified by bytes 22 and 23 (see Note 4). 

All other values reserved. 

25 Reserved 



Cryptography options 

26 0-1 Private cryptography options: 

B'00* X No private cryptography supported. 

B'01* X Private cryptography supported. The session cryptography key 

and cryptography protocols are privately supplied by the end 

user. 
B f 10* Reserved 
B^l* Reserved 

(26) 2-3 Session-level cryptography options: 

B f 00 f X No session-level cryptography supported. 

B'01' X Session-level selective cryptography supported. All cryptogra- 
phy key management is supported by the SSCP and LU* exchange 
(using +RSP to BIND) and verification (using CRV) of the cryp- 
tography session-seed value are supported by the LUs for the 
session. All FM data requests with EDI (enciphered data indica- 
tor) on sr& enciphered/deciphered. 

B'10 f Reserved 

B'll* X Session-level mandatory cryptography supported* same as 
session-level selective cryptography except all FM data 
requests are enciphered/deciphered. 

(26) 4-7 Session-level cryptography options field length: 

X*0* X No session-level cryptography specified. The cryptography 
option fields (bytes 27-k) are omitted. 
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Byte Bi ts Value Opt Pi scussi on 

X*9' X Session-level cryptography specified. Additional options 
follow in the next nine bytes. 

27 0-1 Session cryptography key encipherment mode: 

B'00* X Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key using a seed value of zero (only 
value def i ned) . 

(27) 2-$ Reserved 

(27) 5-7 Cryptography cipher method: 

B'000' X Block chaining with seed and cipher text feedback, using the 

data encryption standard (DES) algorithm (only value defined). 

28-k X Session cryptography key enciphered under BIND receiver (or 

SLU) master cryptography key; an eight-byte value that, when 
deciphered, yields the session cryptography key used for enci- 
phering and deciphering FM data requests. 

Namas and End User Data 

k+1 Length of BIND sender's (or PLU) name in field k+2-m. 

X'00' Field k+2-m does not exist. 

X'nn' X Field k+2-m contains the number of bytes specified (cannot 
exceed X'08»). 

k+2-m X BIND sender's (or PLU) name. 

m+1 Length of user data in field m+2-n. 

X'00' Field m+2-n does not exist. 

X'nn' X Field m+2-n contains the number of bytes specified. 

m+2-n X User data. 

m+2 X User data key. 

X'00' X Structured subfields follow. 

-X'00' X First byte of unstructured user data. 

Note: The unstructured user data continues in m+3 and goes to 
byte n. For information on structured subfields, see the BIND 
information in SNA Format and Protocol Reference Manual: Archi' 
tecture Logic. 

n+1 Length of user request correlation field. 

X'00* Field n+2-p does not exist. 

X'nn" X Field n+2-p contains the number of bytes specified. 

n+2-p X User request correlation field. 

p+1 Length of BIND receiver's (or SLU) name in field p+2-r. 

X'OO* Field p+2-r does not exist. 

X'nn' X Field p+2-r contains the number of bytes specified (cannot 
exceed X'08'). 

p+2-r X BIND receiver's (or SLU) name. 
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Notes 



The following notes apply to the BIND SESSION request: 

Note 1: Buffer sizes can be speci f i ed usi ng byte 24, or byte 24 can refer to 
the buffer sizes defined in bytes 20-21 and, as required, bytes 22-23. 

If the SNA 3270 data stream is used, byte 24, bits 1-7, may specify only 
B*0000000*, B*0000001*, or B'0000010*. The B'0000000* value permits either a 
480 or 1920 screen size. If any functions above the base set of the SNA 3270 
data stream are used, byte 24 may specify any of the defined values. 

If the data being loaded in the buffer exceeds the designated buffer limit, 
the remainder of the data is wrapped, that is, loaded starting at the first 
buffer position. With one exception, the buffer wraps at the value(s) speci- 
fied in BIND regardless of the actual size of the buffer. The exception is 
the byte 24, bits 1-7, value of B'0000000*; the buffer wraps at the end of the 
actual buffer size (480 or 1920). 

Note 2: The buffer size is fixed for the duration of the session when this 
mode is selected. When in this mode, an Erase/Write Alternate command may be 
rejected with negative response X'1003". 

Note 3: If byte 24, bits 1-7, contain B*1111110*, the buffer size specified 
in bytes 20-21 is static. Bytes 22-23 are not used. When in this mode, an 
Erase/Write Alternate command may be rejected with negative response X*1003*. 

Valid row and column parameters for default bytes 20-21 can be found in 
implementation literature. The product of the number of rows (byte 20) and 
columns (byte 21) must not exceed 4096 for the base set of the SNA 3270 data 
stream (upper limit of order stream addressing), and 65536 when the base set 
is extended with additional functions. 

Note 4: An alternate buffer size may be specified if byte 24, bits 1-7, 
contain 8*1111111* (dynamic buffer size switching within a session). 

The BIND operati on establishes both default (bytes 20-21) and alternate 
(bytes 22-23) buffer sizes to be used within a session. It initializes the 
unit by setting it in the default buffer size mode. 

An Erase/Write Alternate command changes the buffer size from default to 
alternate. An Erase/Write command or depression of the CLEAR key changes the 
buffer size from alternate to default. 

Valid row and column parameters for default bytes 20-21 and alternate bytes 
22-23 can be found in implementation literature. The product of the number 
of rows and columns must not exceed 4096 for the base set of the SNA 3270 data 
stream (upper limit of order stream addressing), and 65536 when the base set 
i s extended with additional functions. 
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PART 1 CHAPTER 5. LU-LU SESSION TYPE 4 



Type 4 LU-LU sessions are used for data communications between two terminals 
or between application programs and single- or multiple-device terminals. 
Type 4 sessions are similar to type 1 sessions, particularly for data proc- 
essing applications. In addition, word processing applications can execute 
using type 4 sessions. 

LU_T4 sessions may occur as peei — to-peer sessions or as PLU/SLU sessions. In 
peei — to-peer sessions, the relationship between half-sessions is 
symmetrical; that is, the LU at either end of the session is of equal standing 
(a peer) with the LU at the other end. In PLU/SLU sessions, the relationship 
is asymmetrical, and the primary LU controls the session. 

In peei — to-peer sessions, the operational protocols are symmetrical. This 
implies, among other things, that an LU must recover from its own errors 
occurring in data, since there is no primary LU to do so. It further implies 
that an LU is never the master of the other LU in the session, and that one LU 
has no recovery responsibility for the other LU*s data. 

In the peei — to-peer environment, the terms primary LU and secondary LU no 
longer retain their traditional meaning. For convenience and to preserve the 
analogy to the terminology used by other LU types, the LU that sends the BIND 
SESSION request will be called the primary LU, and the LU that receives BIND 
SESSION will be called the secondary LU. However, these terms are used only 
in the description of the BIND and UNBIND procedures, since, other than 
during these procedures, either LU in the session may start any sequence of 
acti vi ty . 

In addition to peei — to-peer sessions, LU_T4 implementations ar& capable of 
operating in a network controlled by an SSCP using PLU/SLU sessions. To do 
so, the session partners must conform to the SSCP network and session acti- 
vation and deactivation procedures. After the activation procedures are 
accomplished, the partners either: 

Consider the other LU in the session to be its peer, or 

Operate in a nonpeer environment (as a PLU or SLU in a PLU/SLU session). 
This mode of operation enables LU_T4 products to be supported by current 
PLU implementations. 

The proper selection of BIND parameters enables an LU_T4 product to select a 
peei — peer or PLU-SLU session. 

LU_T4 is used to manage input/output devices, such as printers, card readers, 
card punches, and various storage devices. An operator console is often 
present for further input/output in an interactive mode or for diagnostic 
messages. 

In addition, some LU_T4 implementations perform various data management func- 
tions, such as storing data for later retrieval and modification by the send- 
er or for later distribution to multiple destinations. Application programs 
and application subsystems may use type 4 sessions in order to communicate 
with the other type 4 implementations in their network. 

Product implementors are not required to implement all options of the LU_T4 
protocol. The options implemented by a particular product are specified in 
the BIND that it sends to start a session or in the BIND response that it 
sends (for a negotiable BIND), or in the mode that it selects for Initiate (to 
invoke a nonnegotiable BIND). 



BIND SESSION REQUEST 



There are two types of BIND — nonnegotiable and negotiable. The former is 
used primarily with products using PLU-SLU sessions, while the latter is used 
with peei — to-peer sessions. 
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The nonnegotiable BIND has the BIND sender establishing the session parame- 
ters without compromise on potentially negotiable characteristics such as 
maximum RU size and pacing counts. This requires the BIND sender to store the 
characteristics of each different type of station supported in the SNA commu- 
nications network. 

The negotiable BIND has the BIND sender proposing a set of session 
parameters, and the BIND receiver adapting where possible and returning a set 
of response parameters, which together establish the negotiated limits for 
exchanges in both directions. The sender of a negotiable BIND, upon receipt 
of the BIND response, checks the returned parameters and accepts the session 
as negotiated or sends UNBIND to the session partner. 

NEGOTIABLE BIND REQUESTS AND RESPONSES 

Logical units (LUs) negotiate the protocols they wish to use for LU_T4 
sessions by sending to each other a negotiable BIND request and an appropri- 
ate response. The first LU to send a BIND request becomes the BIND sender and 
the other LU becomes the BIND receiver. The BIND sender includes his receive 
capability and his proposal for his send protocol in his BIND request. The 
BIND receiver examines the BIND request and either accepts the session param- 
eters by returning a positive response with the same session parameters, or 
negotiates the session parameters by returning a positive response with 
different session parameters. This process is illustrated below: 

BIND 
BIND sender > BIND receiver 

+RSP, parameters 

BIND response < BIND response 

receiver sender 

Although other capabilities apply (such as security and user information), 
the key to establishing a session is the exchange of receive capabilities. 
Once an LU-LU session is established, an LU must not exceed the receive capa- 
bility of the session partner — so the BIND process must ensure that there is 
a send-receive match. A negotiable BIND may be rejected only on the basis of 
the session partner's receive capability; that is, a negative response may be 
sent only when the BIND receiver determines that a viable session cannot be 
conducted because it cannot send what the BIND sender can receive. 

When the BIND receiver sends a positive response but changes the session 
parameters, the BIND sender may send UNBIND only on the basis of the session 
partner's receive capability; that is, it cannot send what the BIND receiver 
can receive. 



HALF-SESSION CHARACTERISTICS 



FM, TS, AND PS PROFILES 

LU_T4 uses FM profile 7 and TS profile 7. The SNA requests that are allowed 
with each profile are found in SNA Reference Summary. 

LU_T4 uses a PS profile that allows: 

• Function management headers. LU_T4 implementations can run with or without 
FM headers. FM header functions are discussed in Part 2 Chapter 4; consid- 
erations and restrictions that are unique to LU_T4 are discussed under "FM 
Header Processing" on page 78. 

♦ Data streams. Functions listed in Part 2 Chapter 1 are allowed except where 
restricted under "Data Stream Profiles" on page 84. 
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TC (TRANSMISSION CONTROL) CONSIDERATIONS 

Sequence numbers are not used with TS profile 7. Transmission control 
services, such as pacing and cryptography, are summarized in SNA Concepts and 
Products and defined in SNA Format and Protocol Reference Manual: Architec- 
ture Logic. 

DFC (DATA FLOM CONTROL) CONSIDERATIONS 

The send-receive mode used by LU_T4 is half-duplex flip-flop with no 
contention error processing state. 

Data flow control services, such as chaining, brackets, and send/receive 

modes, are summarized in SNA Concepts and Products and defined in SNA Format 
and Protocol Reference Manual: Architecture Logic. The following paragraphs 
give additional considerations. 

SEND-RECEIVE MODES 

LU_T4 implementations must use half-duplex flip-flop as the send-receive 
mode. Half-duplex contention and full duplex are not allowed. 

BRACKET PROTOCOLS 

LU_T4 implementations may choose to use brackets to delimit a unit of work. 
Either half-session may be the bracket first speaker (contention winner) as 
defined in BIND SESSION byte 7, bit 3. 

FM profile 7 does not allow the BID request. To avoid confusion during a 
bracket contention condition Cboth session partners attempting to begin a 
bracket at the same time), the contention loser should send the RU that 
begins the bracket BB,RQD (request definite response). 

Destination selection cannot span brackets. Multiple destinations may be 
selected within a bracket. 

CHANGE-DIRECTION (CD) MANAGEMENT 

Use of CD Indicator (CDI): The sending of the CDI should occur under the 

following circumstances: 

• An LU has reached an end-of-send data-transition condition (including any 
keyboarded data on the LU flow). 

• An LU has received SIG X'OOOlxxxx' (request change direction). The proce- 
dures that must be followed when returning the CDI are discussed below 
under "Signal Codes." 

• An LU has been session-activated in the send state, but has no data traffic 
to send. 

• At session activation, the BIND sender receives a BIND response (or a CINIT 
in a PU type 5 node) with an indication that the BIND receiver must send 
data f i rst . 

The sending of the CDI must occur under the following circumstances: 

• When there is no data to send and the BIND parameters specify that the 
session partner must receive CD on every EDS (end of destination 
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selection). This includes the implied EDS at the end of a transmission to 

the console, 

• When the LU receives CD and the LU doesn't have the capability to send data 
(for example, a printer). In this case, the CDI is returned as part of 
LUSTAT X'0002'. 

The CDI may be returned as part of LUSTAT X f 0007 f . 

An LU should send available FM data, if any, when the CDI is received. If 
there is no FM data pending, the LU must wait for additional FM data to send 
or for one of the conditions described above. 

Use of SIG (Signal): An LU that is capable of sending FM data must be capable 
of sending SIG X,' 00010000* (request change direction), under operator control 
or automatically, when in receive state with FM data to send. 

The sender of SIG X' 00010000 'must return the CDI when it has no more data to 

send. 

The receiver of SIG X'00010000* must not send SIG X T 00010000 T after sending 
the CDI until the end-chain indicator (ECI) has been returned. This prevents 
a signal ping/pong condition from occurring with no data flowing. 

Data Direction Resolution: The BIND parameters indicate whether the BIND 
sender or the BIND receiver will send data first at the beginning of the 
session (see byte 24, bit 2). The BIND sender is always initialized to the 
send state. If this bit indicates that the BIND receiver sends data first 
(value=l), then the BIND sender always begins with CDI or, when applicable, 
the EBI bit on a null RU. 

Si gnal Codes: The SIG request permits an expedited signal to be sent through 
the network, regardless of the status of the normal flows. It carries 4 bytes 
of information set by the sending LU. The signal information has meaning 
only to the LU and is simply passed by the network. Formats are shown and 
fields are described below. 

RU Formats: 

Request byte = X'C9' 

bytes 1-2 = Signal field 

bytes 3-4 = Signal extension field 

Response byte = X T C9 f 

Si g. 
Sig. Extn. 
Fid. Fid. Descripti on 

0000 No-op: Signal extension field may have usei — defined informa- 

tion. 

0001 Signal operator: The sending LU wants to notify the operator 
at the receiving LU to take some type of action. Notification 
can take the form of ringing a bell, turning on a light, and 

so on. 

0002 Component now available. 

0005 Signal operator reset: The sending LU wants to notify the 

operator at the receiving LU to reset the function or action 
taken as a result of receiving SIG with a Signal Extension 
field of X'OOQl*. 

0005 Component stopped as a result of service representative or 
operator action. No data lost. 

0007 Start component. Used by LU receiving intervention required 
(SIG X'0003uuuu') to restart the flow. 

All other codes are reserved. 
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0001 Request change direction: The sending LU is in the receive 
state and wants to be i n the send state. An LU can send data 
on the normal flow only after it has received an RU on the 
normal flow with the change direction indicator (CDI) set on. 

0000 Send CDI immediately: The receiver of request change direc- 
tion* if it is the half-session without recovery responsibil- 
ity* is permitted to clear the active destination from its 
send stack* by abnormal termination if necessary* in conjunc- 
tion with sending the CDI. Normal clearing of the stack 
comprises completing the current chain and deselecting with 
the END (EDS) FMH-1. Abnormal clearing of the stack comprises 
completing the current chain with CANCEL* deselecting with 
the END-ABORT CADS) FMH-1 (or sending LUSTAT (ABORT) if the 
default destination has been selected). In addition, the 
half-session with recovery responsibility may also send a 
single chain console message in conjunction with sending CDI 
after clearing its stack. 

If received by the half-session with recovery responsibility* 
normal and abnormal termination remain the same, but the 
half-session may* after clearing its stack* send a 
single-chain console message with the CDI. 

0001 Send CDI as soon as possible: The receiving LU should send CDI 
but not by prematurely terminating the work in progress. 

All other codes are reserved. 

0002 Request assistance: The signal extension field is used to 
indicate what assistance is desired. 

uuuu User defines what type of assistance is needed. 

0003 Intervention required* no data lost: The signal extension 
field is used to indicate what assistance is required. 

uuuu User defines what type of assistance is needed. 

All other signal field and signal extension field codes are reserved. 

If the receiver does not recognize the code in the signal field* or if the 
receiver recognizes the code but cannot adequately perform the function 
required by the signal field or signal extension field* then the receiver may 
indicate this inability to the sender by negatively responding to SIG with 
sense code X'lOOS* (function not supported). 

Use of LUSTAT X'0002': An LU that does not have the capability to send FM data 
(an output-only component) sends LUSTAT X'0002 1 whenever it receives a change 
direction indicator (CDI). The CDI is set on in the returned LUSTAT command 
so that the LU remains in the receive state. 

When an LU receives LUSTAT X , 0002 f , if it is able and ready to send data, it 
sends it; if it is not ready to send data it either sends UNBIND or RSHUTD, or 
it remains in the send state until it is ready to send more data. 

Use of LUSTAT X^OO?' : An LU that has the capability to send FM data, sends 
LUSTAT X'0007 T when it no longer has such data to send. It is sent at the 
time that the next FM data would have been sent (when LUSTAT X'OOO?* sender is 
in HDX-FF send or contention state). There is no forced turnaround of the 
HDX-FF state (that is, Signal RCD) in order to send LUSTAT X'0007'. 

The implementation must define when the LU has no more data to send. For 
example, an attended termi nal might pause to give the operator the opportu- 
nity to enter a new send job after the last one had been transmitted. 

When an LU receives LUSTAT X'OOO? 1 , if it is able and ready to send data it 
sends it; if it is not able to send data, it sends either UNBIND or RSHUTD; if 
it is able to send data but currently has no data to send, it may wait for 
data to send or receipt of SIG (RCD), or it may return the opportunity to the 
session partner (CD or EB). The following FSM and flow diagram provide a send 
check to prevent unlimited exchange of LUSTAT X^OOO? 1 . 
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Specifying the Change-Direction Mode Using BIND: A parameter in the BIND 
SESSION request specifies i f the change direction indicator (CDI) is to be 
sent on every chain that carries an end of destination selection (EDS or 
BEDS) FMH-1. 

There are two ways that this is done. The first way is to send more than one 
EDS or BEDS without a change in direction. The second way is to set the CDI 
on in the chain that contains EDS or BEDS. 

In the first way* the LU can begin and end many destinations and then end with 
the CDI set on. The receiver of data then separates the data sets for proc- 
essing. This is done in a manner that satisfies the requirements of the 
specific receiver of data in the session. 

In the second way* the LU can begin and end only one destination per chain. 
The LU must send CD in the chain that contains EDS or BEDS. This includes 
sending CD with the implied EDS of a headerless transmission to the console. 
If brackets are used* the LU must not arbitrarily send multiple data sets in a 
bracket since the various receivers of data with which it communicates may 
use a bracket for varying purposes* some of which require that the receiver 
of data control the content of the bracket. 



PS (PRESENTATION SERVICES) CONSIDERATIONS 



DATA STREAMS 



LU_T4 half-sessions use the SNA character string CSCS). The sets of controls 
that are valid are discussed under "Data Stream Profiles" on page 84. 

The data streams that are valid on a session are specified in BIND SESSION 
bytes 15 through 22. The data stream to be sent to a specif ic destinati on is 
specified in the FMH-1 DSP select field. Valid settings for this field are 
discussed under "DSP Select Field of FMH-1" on page 82. 



FM HEADER PROCESSING 



Use Of FMH-1 in LU T4 



The FMH-1 serves four primary functions: defining the beginning and ending 
of jobs* specifying the data stream format* specifying the output medium 
required for the job* and specifying points of suspension and resumption of 
jobs. 

There are restrictions that LU_T4 places on the use of FMH-1 in addition to 
the general rules imposed by Part 2 Chapter 4: 

1. Only the LU that begins a select i on may suspend, resume* end, or abort 
it. An end bracket indicator sent by either session partner ends an 
active destination selection. 



2. 



A destination begun with begin destination selection (BDS) may be termi- 
nated either by end destination selection (EDS) or end-abort destination 
selection (ADS). In either case* a positive response indicates the 
ending of the destination selection. 

Termination with EDS indicates normal completion of the destination 
selection to both LUs. 

Termination with ADS indicates that the desti nati on selection has been 
prematurely terminated. The reason for termination and mechanisms for 
recovery are not addressed* however, responsibility for recovery action 
remains with the applicable LU (BIND sender or RU sender as selected in 
BIND). 
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3. FM data sent without an FMH-1 is routed to the console when FMH usage has 
been indicated in BIND and when there is no active destination. If no 
output device on the LU has been designated as a console* the RU is 
rejected (sense data X'0801'). 

4. All RU chains that carry an FMH-1 must be sent RQD (request definite 
response), regardless of the presence or absence of CDI. 

5. All FMH-ls must be in the first or only RU of a chain. Except for BEDS, 
FMH-ls may not be followed by data. All FMH-ls may be followed by concat- 
enated FMHs; they may not be preceded by either FMHs or data. 

6. BEDS must be in the first or only request of a chain. It may be followed 
by concatenated FMHs or data, within the RU or in subsequent RUs, but it 
may not be preceded by either FMHs or data. 

7. LU_T4 uses FMH-1 to control the beginning, ending, suspension, and 
resumption of destinations. The following subsets of FMH-1 support are 
defined and selected via BIND: 

ONE-LEVEL STACK: An active destination may not be suspended in the same 
direction. An active destination may be implicitly suspended by allowing FM 
data (with or without an FMH) to flow in the opposite direction. If the RU 
carries an FMH selecting any destination other than the console, the data may 
be negatively responded to (sense code X'0801'). 

The restriction of allowing only console data flowing in the opposite direc- 
tion to suspend an active destination is an LU_T4 restriction, not a stack 
manager restriction. 

Example: 

1. BC, EC, FMH (BDS, Print 1) 
> 

2. BC, EC, FMH (SDS) 
> INVALID 

3. SIG (RCD) 

< 

<k BC, EC, FMH (EDS), CD 
> 

5. BC, EC, data, CD 

< 



6. BC, EC, data 



> 



Notes: The numbers on the following notes correspond to the numbers in the 
example above. 

1. Printer is selected. 

2. This is invalid since only one level of destination is allowed in a given 
direction and the suspend destination selection implies a second 
selecti on. 

3. Request for CDI. 

4. Flow turnaround. The sending half-session must terminate the destination 
before sending the CDI. 

5. This may be with or without an explicit FM header. If this chain contains 
an explicit FM header that selects any destination other than the 
console, the chain may be rejected (sense code X'0801'). 

6. Data to the printer continues. 
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TWO-LEVEL STACK? Two levels of selection are allowed. The highest (last) 
selection, however, must be the default header for console. 

Example 1; 

1. BC, EC, FMH (BDS, Print 1) 

._. > 

2. BC, EC, FMH (SDS) 

.«.■ , — > 

3. BC, EC, FMH CBDS, Card 2) 

___ .-..__ > INVALID 

4. BC, EC, data 
._> 

5. BC, EC, data 
> 

6. BC, EC, FMH (RDS) 
> 

7. BC, EC, data 
> 

Notes for Example 1: 

1. Printer is selected. 

2. Printer is suspended. 

3. This selection is invalid since highest (second) level of interruption 
must be default header. 

4. Since the printer is suspended, this headerless data is directed to 

default (console). 

5. See Note 4. 

6. Printer is resumed. 

7. Data to printer. 
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Example 2: 

1. BC, EC, FMH (BDS, Print 1) 
> 

2. SIG (RCD) 

< 

3. BC, EC, CD 

> 

4. BC, EC, FMH (BDS, Card 2) 
< 

5. BC, EC, data 

< 

6. BC, EC, data 

< 

7. BC, EC, FMH (SDS) 

< 

8. BC, EC, data 

< 

9. BC, EC, FMH (RDS) 

< 

10. BC, EC, data 

< 

11. BC, EC, CD, FMH (EDS) 
< 

12. BC, EC, data 
> 

Notes for Example 2: 

1. Printer is selected. 

2. Flow turnaround requested. 

3. Flow turnaround granted. 

4. First level of selection (card) from opposite direction. 

5. Card data. 

6 . Card data. 

7. Card suspension. 

8. Data to default header for console. Second level of interruption must be 
console only (via default). 

9. Card resumption. 

10. Data to card. 

11. Card ended and flow turned around. 

12. Data to printer continued. 

THREE-LEVEL STACK: Three levels of interruption are allowed. The highest 
(last) selection must be the console (explicit or default header). 
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COMPRESSION AND COMPACTION: Compression of FM data using SCBs and compaction 
of FM data using SCBs are optionally supported by implementations of LU_T4. 
The use of either compression or compaction requires FMH-1 for beginning and 
ending the compressed or compacted data. Either LU in the session may estab- 
lish or change the compaction table to be used by sending a Compaction Table 
FMH-3. The rules for FMH-3 are discussed below under "Use of FMH-3 in LU_T4." 

DSP SELECT FIELD OF FMH-1: The DSP Select field of the FMH-1 is coded as 



follows f 


or LU_T4: 




Byte 3 






Bits 4-7 


DSP Select 




X'O' 


Default DSP 




X'l* 


Base DSP 




X'2* 


General DSP 




X'3* 


Job DSP 




X'4 T 


WP raw-form 


DSP 


X'5' 


WP exchange 


di skette 



All other values are reserved. 



USS Of FMH-2 in LU T4 



The previous section showed how the FMH-1 was used to define the beginning 
and ending of jobs, specify the data stream format, specify the output medium 
required for the job, and specify points of suspension and resumption of 
jobs. FMH-2 provides processing parameters for FM data. These parameters 
include presentation services specifications, horizontal tab stops, vertical 
line spacing, output type style, and format-control information. 



Use Of FMH-3 in LU T4 



Either LU in the session may establish or change the compaction table by 
sending a compaction table FMH-3. The rules associated with this header are: 

1. Until one of the LUs sends a compaction table header, compacted data is 
not allowed. 

2. A compaction table becomes effective when the positive response to the 
compaction table header is issued and remains effective until another 
becomes effective or until the end of the session. 

3. The effective compaction table applies to all FM data sent in either 
direction during its period of effectiveness. This includes data sent 
from either LU, and it includes data sent to destinations that were 
suspended when the compaction table became effective but are resumed 
during its period of effectiveness. 

4. Since LU_T4 supports only HDX-FF in brackets, there is no race condition 
between the two LUs as they try to establish compaction tables. 

5. LU_T4 supports the QUERY FOR COMPACTION TABLE FMH-3, requesting that the 
other LU establish the compaction table. 

6. The first RU of a chain must start with a string control byte (SCB). The 
SCB follows the FMH-2, if present, unless the next byte is another FMH-2. 
The SCB and count may reflect spanning across RUs after the first SCB. 
The last SCB in the last RU points to one byte beyond the length of the RU 
except for repeated prime character (see Part 2 Chapter 5). 
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GENERAL CONSIDERATIONS 



INTERVENTION-REQUIRED CONDITIONS 

When an intervention-required condition occurs, such as a printer being out 
of paper, the LU may handle the condition using the following options: 

• Time out. Start a timer of between and 10 minutes* duration. During this 
time, manually correct the condition. If the condition cannot be 
corrected, the LU sends a negative response with the sense code defining 
the original problem. 

If there is a requirement to notify the session partner of an 
intervention-required condition early, option 3 may be used in conjunction 
wi th option 1. 

• Send signal and timeout. Send SIG X f 0003uuuu f (intervention required - no 
data loss), which permits an expedited signal to be sent through the 
network, regardless of the status of the normal flow. Start a timer of 
between and 10 minutes' duration. During this time, manually correct the 
condition. If the condition can be corrected, send SIG X'00000002 1 (compo- 
nent now available). If the condition cannot be corrected by the end of the 
time period, then send a negative response with the sense code defining the 
original problem. 

In a peer-to-peer environment, the need for a timer is optional. In a 
nonpeer environment, the timer is mandatory. 



• Send negative response X'0802 f and LUSTAT X T 0001 f . This response is 
precluded in a peei — to-peer environment; in a nonpeer environment, it 
allowed. 



l s 



The half-session responsible for recovery, upon receipt of a negative 
response, enters (S, -R) state and must send to continue ERP activity. 



ATTENDED AND UNATTENDED MODES OF OPERATION 

An attended session has an operator available to satisfy 

intervention-required conditions and otherwise respond to requests for oper- 
ator action. When operating in the unattended mode, it must be assumed that 
an operator is not available to respond to requests, and the effects of this 
mode are described below. 

• The session partners need not display console messages to an operator on 
line, but may file them for future operator interpretation. This filing 
and future action by the LU is not architected. 

• If CD is sent to the LU and the LU does not have the capability to send FM 
data, it must send LUSTAT X f 0002rrrr T . 

• If CD i s sent to the LU, and the LU has the capability to send but has no FM 
data to send, it must send one of the following: 

LUSTAT X T 0002rrrr» or X*0007rrrr f (no data to send) 

RU without data but with CDI set on 

UNBIND 

RSHUTD 

• Since intervention required (SIG X*0003uuuu f ) cannot be executed by the 
programmed operator, a request not executable response (negative response 
X'081Cuuuu') is issued by the LU. 

• Card data may or may not be written to disk on receipt for later punching. 
(This is also true of attended operation.) If not written to a disk, a 
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request not executable response (X* 081Cuuuu f ) is issued when the card 
receipt processor runs out of cards. 

• The combination of unattended operation and request not executable (receipt 
of negative response) is not architected and the receiver may take any 
acti on requi red. 

An LU may send the following status codes in LUSTAT if the BIND parameters 
permit switching between attended and unattended modes: 

0003 - Entering attended mode of operation 

0004 - Entering unattended mode of operation 



DATA STREAM PROFILES 



INTRODUCTION 



Data stream profiles (DSPs) define the presentation space attributes of FM 
data. The repertoire of DSPs that a half-session is capable of receiving is 
indicated in the BIND images exchanged at session initiation (see BIND 
SESSION bytes 15-16 and 19-20). The repertoire of DSPs indicated in BIND 
implies that the attributes of each of these data streams are fully supported 
by the half-session when it receives FM data. As a receiver, the 
half-session processes these data streams as defined in Part 2 Chapter 1 and 
in the product libraries of products that have implemented LU_T4 
half-sessi ons. 

FM Headers: During the life of the session, FM data exchanges are controlled 
by FM headers. DSP selection for a particular FM data exchange is indicated 
by the DSP field (byte 3) when the destination is selected using FMH-1. 

During a session, when a data stream selection has been made with a BEGIN 
FMH-1 (DSSEL field = B f 010') and accepted by the receiver, the attributes 
specified in the FMH-1 are assumed on all subsequent data exchanges for that 
destination selection, until the END or END/ABORT FMH-1 or end bracket is 
sent. 

The DSP selection is made by the sender of the BEGIN or BEGIN/END FMH-1 to 
indicate the desired attributes for processing the associated FM data. The 
receiver of the FMH-1, by accepting the DSP selected, processes the FM data 
that follows exactly as defined in the DSP definition. The receiver may also 
accept data whose attributes do not conform to the selected DSP. If the 
receiver can process the data as indicated by these additional attributes, it 
should be done; if not, then either the standard default action should be 
invoked or an error response returned to the sender. 

When a DSP selection is made by the sender that does not conform to the repei — 
toire agreed to at BIND, the receiver may reject the data stream (sense code 
X' 10Q8 i +00E t ) , or the receiver may attempt to process the data stream using 
defaults where unable to execute as indicated. 

All presentation space controls of the SCS data stream are in effect upon 
receipt, from BDS to the corresponding EDS. The EDS for the selected desti- 
nation resets all SCS controls to their default values. ADS and other abnor- 
mal terminations of the selected destination also reset the SCS controls to 
their default values. This implies that the controls are in effect as long as 
the destination is on the stack. 

In summary, data stream selection is performed by the sender of data and 
enforcement of the selected data stream is performed by the receiver of data. 
The receiver can also exercise an option on how to handle attributes that do 
not conform to the selected data stream. 

Base Data Stream Profile: The base DSP is the minimum SCS control and graphic 
character set and i s mandatory for all products to assure a minimum level of 
compatibility. The graphic character set of the base DSP, with no SCS 
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MEDIA 



control characters allowed, is used in the user field of BIND, in any 
exchange of security information, in any data set name field of an FMH-1 and 
in store-and-forward addressing for document distribution. 

The base DSP is the required character set to be used for sending and receiv- 
ing any console or supervisory services messages, although a less restrictive 
character set may be used between products if successful use has been assured 
by the BIND parameters. 

Two SCS controls can appear in the Base DSP: New Line (NL) and Form Feed 
(FF). Neither has a default. FF is meaningless in continuous-roll paper-fed 
printers and is treated as NL. 

The graphic character set for base DSP is the 48-character set which includes 
space, the uppercase alphabet, numerals, and 12 special characters. 

Use of the base DSP in user fields, FM headers, and in supervisory services or 
console messages which may be interpreted by machine must conform to the base 
DSP control and character set. However, it is recommended that coordinating 
messages exchanged between operators should not be rejected for failure to 
comply with this character set restriction; the receiving operator may clari- 
fy any ambiguity by a continuing interactive exchange. Thus, any graphic 
character that is not understood should be defaulted. 

The sender should not assume that the receiver makes any distinction between 
uppercase and lowercase alphabetic characters, either in printing or in 
comparing for correct security, data set name, etc. Any control character 
that is not understood should be defaulted. 



Console: The console in LU_T4 is an SCS device. The set of SCS control chai — 
acters accepted by a given console is specified in BIND (bytes 17 and 22) for 
LU-LU sessions and by CINIT (Control Initiate) for the SSCP-PLU session). 
CINIT is defined in SNA Format and Protocol Reference Manual: Architecture 
Logi c. 

There are several sets of control characters that are supported by type 4 
consoles — a base set (base data stream profile) supported by all consoles 
and extension sets that are optionally and independently supported. 

Document: The only operational difference between printer and console that 
affects the session is that the console presentation surface is shared 
between the SSCP-LU session and the LU-LU sessions. (See "Console" above.) 
The printer uses only an LU-LU session. 

Card: The card data stream is an SCS data stream. The ERCL (exchange record 
length) field in the BEGIN or BEGIN/END FMH-1 specifies the point at which an 
auto-IRS (automatic interrecord separator) is applied. If zero is specified, 
the point at which the auto-IRS is applied is defined by prior agreement 
between the session partners. 

A chain consists of one or more card images. LU_T4 allows a card to begin in 
one RU and be continued in the next RU, as long as the RUs are in the same 
chain. These RUs are known as card-spanning RUs. Cards may not be spanned 
across chains. The sending LU must enforce this restriction. 

Card images within a chain are normally delimited by IRS. There are f 
however, two other implicit delimiters. The maximum presentation position 
(MPP), as specified in the BEGIN or BEGIN/END FMH-1 or understood by the 
session partners, is optionally applicable. The end of the chain is required 
and always appli es. If either of these limits is reached before an IRS is 
found, the current card image is complete. In the case of MPP having been 
reached, if an IRS is found at MPP + 1, it is associated with the card image 
just completed. If it is not an IRS, it is associated with the next card 
image. This is known as automatic IRS. 

Transparency may also be used for card data. There is no restriction on the 
appearance of a transparent string within the card data. The TRN escape 
sequence (TRN and count) may appear at any point with respect to card image 
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boundaries, and the count may run out at any point. The count field may 
describe a number of bytes that constitute all or part of one or more card 
images. The auto-IRS function, if applicable, is still active even if the 
transparency count has not run out. the transparency count, like card 
images, may span RUs but not chains. 

Exchange: The sender of data, for application oriented reasons, may require 
that the receiver store the data on a removable medium that can be trans- 
ported to another machine for processing. When this requirement exists, the 
sender selects exchange medium in the FMH-1 that begins the job. The FMH-1 is 
also used to select the data organization on the medium. The architected 
exchange media place some Preformatting requirements on the data sender and 
some output medium and formatting requirements on the receiver, which are 
di scussed below. 

Basic Exchange: The sender must ensure that the data meets the EBCDIC or 
ASCII standard (as selected in BIND and the RH) and that the value in the ERCL 
(exchange record length) field in the FMH-1 is less than or equal to 128. The 
receiver creates from this data a data set which it stores on an exchange 
medium (of any physical type) that has been formatted according to Basic 
Exchange standards. The algorithm for doing so is: 

1. The entire stream of data in a chain is considered as a unit. 

2. The data is scanned until the enchange record length is reached. 

3. The scanned data becomes the content of a logical record in the data set. 

4. Scanning continues with the next byte of the data stream and steps 2 and 3 
are repeated. 

Implied Media Support for Data Processing Media: The following DSP support 
indicated in the BIND implies media support in FMH-1: 

1. At least job DSP supported for printer (byte 15, 19, or both) implies 
document media support. 

2. At least base DSP supported for console (byte 17, 21, or both) implies 
console media support. 

3. Card DSP support (byte 16, 20, or both) implies card media support. 

4. Basic exchange DSP support (byte 16, 20, or both) implies exchange medium 

support. 

5. Any word processing DSP support implies WP media 1, 2, 3, and 4. 



DATA PROCESSING DATA STREAM PROFILES 

All profiles described below apply to data processing data stream profiles 
and not word processing data stream profiles. 

The profiles arQi 

1. Base data stream (see "Base Data Stream Profile" above) 

Control character Abbreviati on 

Form feed FF 

New line NL 
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2. General data stream. The general data stream contains the base data 

stream> plus: 

Control character Abbreviati on 

Carriage return CR 

Line feed LF 

Bell BEL 

Presentation position PP 

(absolute vertical* 

relative horizontal) 

Set graphic error action SGEA 

Set chain image SCI 

Set horizontal format (MPP) SHF 

Set vertical format (MPL) SVF 

3. Job data stream. The job data stream contains the base data stream* plus: 

Control character Abbreviati on 

Carriage return CR 

Line feed LF 

Set horizontal format SHF 

(with parameters) 

Horizontal tab HT 

Set vertical format SVF 

(with parameters) 

Vertical tab VT 

Backspace BS 

Vertical Channel Select VCS 

(with parameters) 

Transparency TRN 

(with count and data) 

Interchange record separator IRS 

WORD PROCESSING (UP) DATA STREAM PROFILES 

WP text is a sequential stream of graphics and format controls. The text is 
ordered into lines and pages and separated by line- and page-ending SCS 
controls. 

Base Data Stream Profile: The WP base data stream profile is identical to the 
DP base data stream profile as described in "Base Data Stream Profile" above. 

Word Processing Raw-Form Text Data Stream Profile: The WP raw-form text DSP 
is used where further revision* processing* or reformatting may be done by a 
recipient. Because of the use of the extended WP control character set, this 
DSP can not be represented in a 7-bit code. 

Since word processing i s to be performed subsequent to transmission, record- 
ing on a machine-readable device is mandatory unless the entire extent of the 
processing is done concurrently with reception. Also, alphanumeric control 
information may be included to indicate to the recipient the intent of the 
originator. To interchange raw-form text* the originator must know the chai — 
acteri sties of the target machine and represent such control information in a 
manner that will be acceptable to the reci pi ent(s) . 

In the absence of format-control information included within WP raw-form 
text* the default values shown in Figure 5-1 are recommended as standard. 

Since further revision* processing, and reformatti ng may be performed subse- 
quent to transmission, the choice of parameters may be made during such proc- 
essing without relying on the exchange of format-control information from the 
originator. The SCS control characters that can appear in a WP raw-form DSP 
are listed in Figure 5-2 along with their allowable defaults. 

No error condition may b 
ter appears in the data 
a multiple-character co 




Part 1 Chapter 5. LU-LU Session Type 4 87 



Parameter 

Paper source selection 

Keyboard identification 

Type style* pitch 

Quantity 

Top margin 

Left margin 

Vertical line spacing 

Horizontal tab settings 

Printing line width 

Headings 

Page numbers/footings 



Recommended Default 

Primary 

US 1 

Elite, 12 

1 

1 inch 

1.5 inches 

6 per inch 

Every 5 characters from the left margin 
(position 5, 10, 15, etc) 
6 inches 

0.5 inches from top of page 

Centered, 0.5 inches from bottom of page 



Figure 5-1. Defaults for WP raw-form text DSP. 

character, as appropriate, to assist in subsequent correction. In accepting 
a WP raw-form text DSP, acceptance of space (SP), numeric space CNSP), 
required space (RSP), syllable hyphen (SHY), and the full 96-character WP 
graphic set is mandatory. Use of a substitute graphic is permitted where the 
print element (or equivalent) includes fewer than 96 graphics, and no error 
may be indicated if any other graphic character appears in the data stream, 
as it is assumed that the recipient may readily revise the text to make a 
correction. 

For fixed-pitch printing, those control and graphic characters that are mean- 
ingful only in proportional escapement printing are defaulted as shown in 
Fi gure 5-3. 
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Magneti c 










Card 






Functi on 


Abbreviati on 


Code 


Default 


EBCDIC 


Backspace 


(BS) 


4A 


X 


16 


Carrier return 


CCREHNL) 


2B 


X 


15 


Horizontal tab 


(HT) 


2A 


Space 


05 


Indent tab 


(IT) 


6A 


Tab 


39 


Index 


(INXKLF) 


OB 


x 


25 


Index return 


(IR) 


4B 


CR 


33 


Null 


(NUL) 


33 


X 


00 


Numeric backspace 


(NBSHEBS) 


52 


BS 


36 


Numeric space 


CNSPKESP) 


78 


SP 


El 


Page end 


(PEUFF) 


7A 


NL 


OC 


Repeat 


(RPT) 


7B 


STOP 


0A 


Required carrier return 


(RCRURNL) 


6B 


CR 


06 


Required page end 


(RPEMRFF) 


(1A,7A) 


PE 


3A 


Stop 


(STP) 


32 


X 


2F 


Subscri pt 


(SBS) 


23 


NULL 


38 


Substi tute 


(SUB) 


13 


X 


3F 


Superscript 


(SPS) 


03 


NULL 


09 


Swi ten 


(SW) 


22 


STOP 


2A 


Unit backspace 


(UBS) 


42 


NULL 


1A 


Word underscore 


(WUS) 


12 


NULL 


23 



(1) 

(2) 



(3) 



(1) 



xBase Code must support 

Note 1; These control characters are meaningful only in proportional escape- 
ment printing. They are permitted in a DSP where the destination is a printer 
which does not support proportional escapement control characters, and 
defaults as indicated are permitted only in fixed-pitch printing. 

Note 2: Page end defaults to new line only in printers using roll or contin- 
uous-paper feed. 

Note 3: More than one default is permitted. 

Figure 5~2. SCS controls for WP raw-form text DSP. 



Character Default 

Numeric backspace (NBS) Backspace 

Numeric space (NSP) Space 

Unit backspace (UBS) No-op 



Fi gure 5-3. 
pri nting. 



Defaults for proportional escapement characters in fixed-pitch 



SENSE CODES AND SENSE DATA 



SENSE CODES FOR LU T4 SESSIONS 



The following sense codes may be sent by LU_T4 half-sessions. Except for 
request error X'1QQ8*> complete descriptions are in SNA Format and Protocol 
Reference Manual: Architecture Logic. 

Request Reject: 08xx 



0801 Resource not available 

0802 Intervention required 
0809 Mode inconsistency 
080A Permission rejected — 



SSCP not notified 
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080D LU contention 

080E LU not authorized 

080F End user not authorized 

0811 Break 

0812 Insufficient resource 

0813 Bracket bid reject 
0815 Function active 

Q81C Request not executable 

0821 Invalid session parameters 

0824 Unit of work aborted 

0825 Component not available 

0827 Intermittent error — retry requested 

0829 Change direction required 

082D LU busy 

Request Errors: lOxx 

1001 RU data error 

1002 RU length error 
1005 Parameter error 
1008 Invalid FM header 



When 1008, invalid FM header, is returned, bytes 
2 and 3 of the sense may contain X'0000 f or 
may optionally contain a detailed explanation of 
the FM header error, as follows: 

1008 0801 Invalid function code parameters 

1008 0803 Forms function cannot be performed 

1008 0805 Unable to perform copy function 

1008 0806 Compaction table outside supported set 

1008 0807 Invalid PDIR identifier 

1008 0808 Train function cannot be performed 

1008 0809 FCB load function cannot be performed 

1008 080A FCB load function not supported 

compaction table name 



inn« nana 



1008 080C Invalid access 

1008 080D Invalid RECLEN 

1008 080E Invalid NUMRECS 

1008 080F Data set in use 

1008 0810 Data set not found 

1008 0811 Invalid password 

1008 0812 Function not allowed for destination 

1008 0813 Record too long 

1008 0814 Data set full 

1008 0815 Invalid RECID 

1008 0817 Invalid VOLID format 

1008 0818 Number of logical records per chain exceeded 

1008 0819 Data set exists 

1008 081A No space available 

1008 081B Invalid VOLID 

1008 081C Invalid DSACCESS 

1008 081D Invalid RECTYPE 

1008 081E Insufficient resolution space 

1008 081F Invalid key technique 

1008 0820 Invalid key displacement 

1008 0821 Invalid key 

1008 0822 Invalid N (number) 

1008 0823 Invalid KEYIND 

1008 0824 Invalid SERID 

1008 0826 Invalid RECID format 

1008 0827 Password not supplied 

1008 0828 Record ID not supplied 

1008 0829 Volume ID not supplied 

1008 082A Invalid PGMNAME 

1008 2001 Invalid destination — active 

1008 2002 Invalid destination — inactive 

1008 2003 Invalid destination — suspended 

1008 2004 Invalid Suspend-Resume sequence 

1008 2005 Interruption level violation 

1008 2006 Invalid Resume properties 

1008 2007 Destination not available 
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1008 2008 Invalid End sequence 

1008 2009 Invalid FM header length 

1008 200A Invalid field setting 

1008 200B Invalid destination 

1008 200C Invalid ERCL 

1008 200D Invalid DST 

1008 200E Invalid concatenation 

1008 200F FM data not allowed for header 

1008 2010 BIND FM header set violation 

1008 2014 FM header not sent concatenated 

1008 2019 Invalid stack reference indicator (SRI) 

1008 201A Unable to accept CMI modification 

1008 201B Unable to accept CPI modification 

1008 201C Unable to accept ERCL modification 

1008 4001 Invalid FMH type 

1008 4002 Invalid FMH code 

1008 4003 Compression not supported 

1008 4004 Compaction not supported 

1008 4005 Basic exchange not supported 

1008 4006 Only basic exchange supported 

1008 4007 Medium not supported 

1008 4008 Code selection compression violation 

1008 4009 FMHC not supported 

1008 400A Demand select not supported 

1008 400B DSNAME not supported 

1008 400C Invalid media subaddress field 

1008 400D Insufficient resources to perform function requested 

1008 400E DSP select not supported 



LUSTATS FOR LU T4 SESSIONS 



Byte 3 of the LUSTAT RU identifies the component class and device address of 
the LU. Because there are more component classes in LU_T4 than the 
component-medium field can identify, a byte-3 escape character of X'FF f indi- 
cates that byte 4 must be used to identify the component class and device 
address. 

You may use byte 3 of the LUSTAT RU if the component class you desire is 
defined by byte 3. By so doing, the LUSTAT RU for LU_T4 is compatible with 
the other LU-LU session types. 

The following LUSTAT codes may be sent by LU_T4 half-sessions: 

0000 NOP 

0001 Component now available 

0002 No FM data to transmit 

0003 Entering attended mode of operation 

0004 Entering unattended mode of operation 
0007 Sender currently has no data to transmit 
0802 Component failure — intervention required 
081C Component failure — permanent error 

0824 Function canceled 

The format of LUSTAT is: 

Byte Value Definition 

X t 04' Request code 

1-4 Status value and status extension field 

(two bytes each) 

X* 0000 f + 'uuuu' User status (no system defined status) and 
usei — defined field (uuuu) 

X'OOO^ + 'ccdd* Component now available (0001) and 
component identification (ccdd) 

X , 0002 , +'rrrr l No FMD requests to send and reserved field. 
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X* OOOS'+'ccdd* Entering attended mode of operation (0003) 
and component identification (ccdd) 

X* 0004* + , ccdd T Entering unattended mode of operation (0004) 
and component identification (ccdd) 

X f 0007 *+* rrrr* Sender currently has no data to transmit (0007) 
and reserved field (rrrr) 

X* 0802 , + , ccdd f Component failure - intervention required (0802) 
and component identification (ccdd) 

X' OSlC + 'ccdd* Component failure - permanent error (081C) 
and component identification (ccOQ) 

X* 0824 , + , rrrr f Function canceled (0824) and reserved (rrrr) 

Values for 'cc ! byte are: 

X T 00' = LU itself rather than a specific LU component 

X'FF* = Use *dd f byte rather than 'cc' byte to select LU component 

Otherwi se, 

Bit 0, set to 1 = Media other than LU 

Bits 1-3, LU component class: 

f 000 ? Console 
T 001 T Exchange 
'010 ? Card 
f 011 T Document 
All other values are invalid for LU_T4. 

Bits 4-7 are the LU component device address. 

If LUSTAT byte 3 is X'00*, it refers to the LU itself rather than a specific 
LU component. 

If LUSTAT byte 3 is X'FF», then the values for byte 4 are: 

Bits 0-3 are the LU component-medium class 
(DSP in parentheses below is default DSP). 

' 0000 * Console 

f 0001 T Exchange 

♦0010* Card 

'0011* Document 

f 0111* Data set name selects destination 

UOOO* WP medium 1 (raw-form text) 

»1001 f WP medium 2 (raw-form text) 

' 1010 * WP medium 3 (raw-form text) 

'HOO* WP medium 4 (raw-form text) 
All other values are invalid for LU_T4. 

Bits 4-7 are the LU component device address. 

LU_T4 does not allow BB (begin bracket) on LUSTAT. 

If any of the four WP medium select code points are supported (used) by an LU 
then all four WP medium codes must be supported. Each WP medium select code 
point must be supported in one of the following ways: 

1. The WP medium select code is assigned a speci fi c medium class, for exam- 
ple, printer, diskette, and so on. Assignment of a WP medium in this 
manner does not affect the default DSP for WP media; the default remains 
WP raw form. 

2. The WP medium select code is defaulted to one of the classes assigned in 1 
above. 

An implementation may provide a user override capability for these medium 
class assi gnments (for example, the implementation assignment for WP Media 1 
to di skette) . 
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If none of the four WP medium select codes is supported* then the receiver of 
an FMH-1 indicating a WP media select should negatively respond with sense 
code X'1008'. 



EXAMPLES OF DATA DELIMITING SEQUENCES 

This section contains information that will help you better understand previ- 
ously discussed LU_T4 architecture. The sequences in the Figures 5-4 through 
5-7 below are illustrative only. Other sequences are allowed. 



LU X 



LU Y 





BC, 


EC, BDS, RQD 








+RSP 






BC, 


data 








data 






EC, 


data, RQD 








+ RSP 






BC, 


EC, EDS, RQD 




< 




+ RSP 





Figure 5-4. Basic data delimiting. 



LU X 



1 EC, RQD 



LU Y 





I SIG CX'OOOIOOOO' ) 

L _ -s 




1 

+RSP | 

— i 




+ RSP 


< 


BC, EC, RQE, CD (RH-only RU) 



goes to receive state 



Figure 5-5. SIG (request to send) while between chains. 
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LU X LU Y 

BC, EC, BDS, RQD 
> 

+ RSP 

< 

BC, data 
> 

data 
> 

TsiG (X'OOOIOOOO') 
< j 

I +RSP 
j > 

I data 

data 
> 

EC, data 
> 

BC, EC, EDS, RQD, CD 
> 

LU X chose to complete the current chain 
and send the CDI in conjunction with EDS 
(the normal completion of the active 
destination selection). 

Figure 5-6. SIG (request to send) usage. 



LU X 



LU Y 



EC, RQE, CD 

SIG (X'00010000') 



CD is sent and LU Y 

SIG arrives in 
receive state (if CD 
had been sent RQD, then 
SIG arrives in receive 
pending state) 



+RSP 



+RSP to SIG. 
the CDI. 



Do not send 



Figure 5-7. SIG (request to send) while in receive state. 
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BIND SESSION FORMATS FOR TYPE * LU-LU SESSIONS 

This section defines valid bit settings for the BIND request. The BIND for 
LU_T4 can be sent as a negotiable or nonnegotiable request. In a negotiable 
BIND, the BIND sender and BIND receiver can negotiate to establish session 
protocols. In the nonnegotiable BIND, the BIND sender specifies the session 
parameters. 

The formats of both the nonnegotiable BIND and the negotiable BIND request 
and response are shown below. For more information on the relationship 
between the types of BIND, see "BIND Request Parameters" at the beginning of 
thi s chapter. 

NONNEGOTIABLE BIND 

Bvte Bits Value Pi scussion 

0-7 X'31' Identifies this RU as a BIND request. 

1 0-3 X f T Specifies the format of the BIND RU. Only one format has been 

defined: format (zero). 

(1) 4-7 Type - denotes the type of BIND to be performed: 

X'l f Nonnegotiable BIND 

FM (Function Management) Profile 

2 0-7 X f 07 T FM profile 7 must be used. 

The FM profile defines data flow control (DFC) protocols. (See 
SNA Reference Summary for highlights of the FM profile.) 

TS (Transmission Subsystem) Profile 

3 0-7 X'07 1 TS profile 7 must be used. 

The TS profile defines transmission control (TO protocols. 
(See SNA Reference Summary for highlights of the TS profile.) 

FM Usage 

(4-7) See bytes 4 through 7 below. 

BIND Sender's send Protocols 

Chaining Use: 

<t B f f Not valid 

B'l* BIND sender can send single or multiple element chains. 

Request Mode Selection: 

(4) 1 B'O* Immediate request mode is used. Only one definite response can 

be outstanding at a time. That response must be received before 
the BIND sender can send another RU. 
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Bvte Bits Value Pi scussi on 

B'l' Delayed request mode is used. Multiple definite responses can 
be outstanding at one time. 

Note: If delayed request mode is used* the RU sender must be 
responsible for recovery. 

Chaining Responses: 

(4) 2-3 B f 00» Not valid 

B l 01» Not valid 

B'10 T Not valid 

B'll* BIND sender can request definite or exception responses. 

(4) 4-5 Reserved 

Compression Indicator: 

(4) 6 B'O' BIND sender cannot send compressed data. 
B'l f BIND sender can send compressed data. 

Note: B'l' is valid only if the code is EBCDIC (see byte 6 bit 4 
and byte 23 bits 4-7). 

Send End Bracket Indicator: 

(4) 7 B'0 f BIND sender will not send EB (see byte 6 bit 2) 
B T l f BIND sender can send EB. 



BIND Receiver's Send Protocols 

Chai ning Use: 

5 B*0' Not valid 

B'l* BIND receiver can send single or multiple element chains. 

Request Mode Selection: 

(5) 1 B ( T Immediate request mode is used. BIND receiver can issue a 

request for a single definite response. No further transmission 
is sent until the BIND receiver receives the response. 
B'l 1 Delayed request mode is used. BIND receiver allows several 
definite responses to be outstanding at one time. 

Note: If delayed request mode is used* the RU sender must be 
responsible for recovery. 

Chaining Responses: 

(5) 2-3 B f 00' Not valid 
B'01' Not valid 
B'10' Not valid 

B'll" BIND receiver can request either definite or exception 
responses. 

(5) 4-5 Reserved 

Compression Indicator: 

(5) 6 B'O* BIND receiver cannot send compressed data. 
B'l* BIND receiver can send compressed data. 

Note: B'l* is valid only if the code is EBCDIC (see byte 6 bit 4 
and byte 23 bits 4-7). 

Send End Bracket Indicator: 

(5) 7 B'O* BIND receiver cannot send EB (see byte 6 bit 2) 
B f l T BIND receiver can send EB. 
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Bvte Bits Value Pi scussi on 
Common Protocols for FM Data 

6 Reserved 

(6) 1 B'O' FM headers not used. 

B'l' BIND sender and BIND receiver can exchange FM headers. 

Brackets Usage and Reset State: 

Note: Brackets are optional in LU_T4 sessions. 

(6) 2 B'O' When brackets are used (byte 4, bit 7 = 1 or byte 5, bit 7 = 1), 

the bracket state manager's reset states are INB (in brackets). 
Brackets are not used if neither BIND sender nor receiver will 
send EB (when byte 4, bit 7 = and byte 5, bit 7 = 0). 
B'l" Not valid 

Bracket Termination Rule Selection: 

(6) 3 B'O' Not valid 

B'l 1 Bracket termination rule 1 is used. 

Note: Bit 3 is reserved if brackets are not used by the 
sessi on. 

Alternate Code Selection: 

Alternate code set will not be used. 

Alternate code set may be used. (See byte 23 bits 4-7.) 

Reserved 

Normal-Flow Send and Receive Mode Selection: 

Not valid 
Not valid 

Half-duplex flip-flop 
Reserved 

Recovery Responsibility: 

The contention loser is responsible for any error recovery 
attempts for the session (asymmetric recovery). 
Symmetric responsibility for recovery. The sender of data is 
responsible for recovery. 

Contention Winner/Loser: 

(7) 3 B'O* BIND receiver is contention winner, and BIND sender is 

contention loser. 
B'l* BIND sender is contention winner, and BIND receiver is 
contention loser. 

Note: Byte 7, bit 3, is reserved if there is symmetric respon- 
sibility for recovery (when byte 7, bit 2 = 1). For asymmetric 
recovery (when byte 7, bit 2 = 0), the session partner responsi 
ble for recovery is the contention loser identified in byte 7, 
bit 3. 

(7) 4-6 Reserved 

Half-Duplex Flip-Flop (HDX-FF) Reset States: 

(7) 7 B'O' Not valid 

B'l' HDX-FF reset state is SEND for the BIND sender and RECEIVE for 
the BIND receiver (that is, the BIND sender sends normal-flow 
requests first after session activation or reset). 
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(6) 


4 


B'O' 
B'l' 


(6) 


5-7 




7 


0-1 


B'00' 
B'01' 
B'10' 
B'll' 


(7) 


2 


B'O' 
B'l' 



Byte Bits Value Pi scussi on 
TS usage 

(8-13) See bytes 8 through 13 below. 

Staging Indicator and Pacing Count for BIND-recei ver CPMGR 
(connection point manager) to BIND-sender CPMGR normal flow: 

8 6*0* Pacing in this direction occurs in one stage. 

B'l* Pacing in this direction occurs in two stages. 

Note 1 : When the session involves a boundary function> pacing 
may occur in two stages. For the definition of a boundary func- 
tion, see SNA Format and Protocol Reference Manual; Architec- 
ture Logi c. 

Note 2: The meanings of and 1 ar& reversed from the staging 
indicator for BIND-sender CPMGR to BIND-recei ver CPMGR (see 
byte 12). 

(8) 1 Reserved 

(8) 2-7 B'nnnnnn* BIND-recei ver CPMGR send pacing count. A value of 000000 means 

no pacing of requests flowing from the BIND receiver. 

9 0-1 Reserved 

(9) 2-7 B'nnnnnn 1 BIND-recei ver CPMGR receive pacing count. A value of 000000 

causes the boundary function to substitute the value set by a 
system definition pacing parameter (if the system definition 
includes such a parameter) before it sends the BIND RU on to the 
BIND receiver. A value of 000000 received at the BIND receiver 
is interpreted to mean no pacing of requests flowing to the BIND 
receiver. 

Maximum RU Si ze: 

10 X f ab f Maximum RU size sent on the normal flow by the BIND receiver. 

This value represents the largest RU that can be sent. It is 
expressed as a mantissa and an exponent value of 2 by which the 
mantissa is multiplied. For example, when the mantissa is 8 and 
the exponent is 5 (X'85*), the RU size is 256 bytes (8 x 2 5 ). 

When bit is set to zero, no maximum is specified and the 
remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab 1 . (See Appendix B for these 
values.) 

11 X'ab* Maximum RU size sent on the normal flow by the BIND sender. 

This value represents the largest RU that can be sent by the 
BIND sender and is specified in the same format as the BIND 
receiver (byte 10). 

Staging Indicator and Pacing Count for BIND-sender CPMGR to 
BIND-recei ver CPMGR normal flow: 

12 B T 0* Pacing in this direction occurs in two stages. 

B , l f Pacing in this direction occurs in one stage. 

Note: The meanings of and 1 are reversed from the staging 
indicator for BIND-recei ver CPMGR to BIND-sender CPMGR (see 
byte 8, notes 1 and 2). 

(12) 1 Reserved 

(12) 2-7 B'nnnnnn* BIND-sender CPMGR send pacing count. A value of 000000 means no 

pacing of requests flowing from the BIND sender. 

For single-stage pacing in the BIND sender to BIND receiver 
direction, this field is redundant with, and will indicate the 
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Bvte Bits Value Pi scussi on 

same value as, the BIND-recei ver CPMGR receive pacing count. 
(See byte 9, bits 2-7 above.) 

13 0-1 Reserved 

(13) 2-7 B'nnnnnn* BIND-sender CPMGR receive pacing count. A value of 000000 means 

no pacing of requests that flow to the BIND sender. For 
single-stage pacing in the BIND receiver to BIND sender direc- 
tion> this field is redundant with, and will indicate the same 
value as, the BIND-recei ver CPMGR send pacing count. (See byte 
8, bits 2-7 above.) 



PS Profile 




(14-25) 




14 


B*0 T 
B'1 T 



See bytes 14 through 25 below. 

PS usage field format is the basic format 
Reserved 



(14) 1-7 B f 0000100» LU-LU session type 4 



PS Usaga 

15-18 BIND SENDER TO BIND RECEIVER DIRECTION 

OF FLOW 

15 Printer data stream profiles 

(Profiles are defined under 
"Data Stream Profiles.") 

Base DSP 

Not supported 

1 Supported 

1 General data stream 

Not supported 

1 Supported 

2 Job data stream 

Not supported 

1 Supported 

3 Reserved 

4 WP raw form data stream 

Not supported 

1 Supported 

5-7 Reserved 



Note: Base DSP with NL and FF is part of all other printer DSPs. 
If bit = 0, no printer is supported on BIND receiver. If bit 
1, 2, or 4 is set to 1, bit must also be 1. 



16 Additional data stream profiles 

(X f 00 f = no additional media) 

For bits through 7 below: 

Not supported 

1 Supported 

Reserved 

1 Card 

2 Reserved 

3 Basic exchange 
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Bytq 


Bits 


Value 


Di scussi on 




4 

5 
6 
7 




Reserved 

Word processing exchange diskette 

Reserved 

Reserved 


17 






Console data stream profiles 




0-3 




Console definition 








1 


Base DSP (see Note 1) 

No console supported (see Note 2) 

Supported 




1 



1 


General data stream 
Not supported 
Supported (see Note 3) 




2 



1 


Job data stream 
Not supported 
Supported (see Note 3) 



3-7 Reserved 

Note: Base DSP with NL and FF is part of all other console DSPs. 
If bit = 0, no console is supported on BIND receiver. If bit 1 
or 2 is set to 1, bit must also be 1. 

18 FM and FMH usage 

Supervisory services FM data 

Not supported 

1 Supported 

1-2 Destination-selection stack 

00 1-level stack 

01 2-level stack 

10 Reserved 

11 3-level stack 

3 Compaction 

Not supported 

1 Supported 

B f l* is valid only if the code is EBCDIC. 
(See byte 6 bit 4 and byte 23 bits 4-7.) 

4 PDIR for all media 

(PDIR is peripheral data information record) 

Not supported 

1 Supported 

5 Reserved 

6 QUERY FOR DATA SET FMH-2 

Not supported 

1 Supported 

7 BIND receiver need not receive CD on every EDS 

(end of destination selection) 
1 BIND receiver must receive CD on every EDS 

19-22 BIND RECEIVER TO BIND SENDER DIRECTION 

OF FLOW 
(Same format as bytes 15-18.) 

19 Printer data stream profiles 

Base DSP 

Not supported 

1. Supported 
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Byte , Bi ts Value Pi scussi on 

1 General data stream 

Not supported 

1 Supported 

2 Job data stream 

Not supported 

1 Supported 

3 Reserved 

4 WP raw form data stream 

Not supported 

1 Supported 

5-7 Reserved 



Note: Base DSP with NL and FF is part of all other printer DSPs. 
If bit = 0, no printer is supported on BIND sender. If bit 1* 
2, or 4 is set to 1, bit must be 1. 



20 Additional data stream profiles 

(X f 00 f = no additional media) 

For bits through 7 below: 

Not supported 

1 Supported 

Reserved 

1 Card 

2 Reserved 

3 Basic exchange 

4 Reserved 

5 Word processing exchange diskette 

6 Reserved 

7 Reserved 

21 Console data stream profiles 
0-3 Console definition 

Base DSP 

Not supported 

1 Supported 

1 General data stream 

Not supported 

1 Supported 

2 Job data stream 

Not supported 

1 Supported 

3-7 Reserved 



Note: Base DSP with NL and FF is part of all other console DSPs. 
If bit = 0, no console is supported on BIND sender. If bit 1 
or 2 is set to 1> bit must also be 1. 



22 FM and FMH usage 

Supervisory services FM data 



1-2 






Not supported 


1 


Supported 




Destination-selection stack 


00 


1-level stack 


01 


2-level stack 


10 


Reserved 


11 


3-level stack 
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Bvte Bits Value Pi scussi on 

3 Compaction 

Not supported 

1 Supported 

4 PDIR for all media 

Not supported 

1 Supported 

5 Reserved 

6 QUERY FOR DATA SET FMH-2 

Not supported 

1 Supported 

? BIND sender need not receive CD on every EDS 

(end of destination selection) 
1 BIND sender must receive CD on every EDS 

23 Code selection 

0-3 Repertoire 

Note: Bits 0-3 are not defined for the nonnegotiable BIND. Use 
bi ts 4-7 instead. 

4-5 Code (main code) selection. 

Specifies the encoding of character 
fields in code during the session. 

00 EBCDIC 

01 ASCII or ISCII or ITA #5 
Other values reserved 

6—7 Cods 1 (alternate code) selection. 

Selects the alternate code 
for the sessi on. 

00 EBCDIC 

01 ASCII or ISCII or ITA #5 
Other values reserved 

If byte 6 bit 4 is B'l', the code selection indicator (CSI 
field of the RH (request header)) controls whether the 
alternate code is to be used. 

24 General characteristics 
0-1 Reserved 

2 BIND sender may send data first 

1 BIND receiver must send data first 

3 Reserved 

4 BIND receiver will initiate attended mode 

(Where operator is available to handle 
intervention-required and other operator 
responses. ) 
1 BIND receiver will initiate unattended 

mode 

5 During session BIND receiver will not 

alternate between attended and unattended mode 
1 During session BIND receiver may 

alternate between attended and unattended mode 

6-7 Reserved 

25 Reserved 
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Cryptography Options 



26 



0-1 



(26) 2-3 



(26) 4-7 



27 0-1 



(27) 2-4 
(27) 5-7 



28-k 



B'OO' 
B'Ol' 


X 
X 


B T 10» 
B'll' 




B f 00» 
B'01' 


X 
X 



Byte Bi ts Value Opt Pi scussion 

An X in OPT column indicates that value is optional. 

Private cryptography options: 

No private cryptography supported. 

Private cryptography supported. The session cryptography key 

and cryptography protocols are privately supplied by the end 

user. 

Reserved 

Reserved 

Session-level cryptography options: 

No session-level cryptography supported. 

Session-level selective cryptography supported. All cryptogra- 
phy key management is supported by the SSCP and LU; exchange 
(using +RSP to BIND) and verification (using CRV) of the cryp- 
tography session-seed value are supported by the LUs for the 
session. All FM data requests with EDI (enciphered data indica- 
tor) on are enciphered/deciphered. 
Reserved 

Session-level mandatory cryptography supported; same as 
session-level selective cryptography except all FM data 
requests are enciphered/deciphered. 

Session-level cryptography options field length: 

No session-level cryptography specified. The cryptography 
option fields (bytes 27-k) are omitted. 

Session-level cryptography specified. Additional options 
follow in the next nine bytes. 

Session cryptography key encipherment mode: 

Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key using a seed value of zero (only 
value defined) . 

Reserved 



B'10' 
BUI' 



X'O' 
X f 9» 

B'OO* 



B'000 1 



Cryptography cipher method: 

Block chaining with seed and cipher text feedback> using the 
Data Encryption Standard (DES) algorithm (only value defined) 

Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key; an eight-byte value that, when 
deciphered, yields the session cryptography key used for enci- 
phering and deciphering FM data requests. 



Names and End User Data 



k+1 



k+2-m 
m+1 



Length of BIND sender 1 s name in field k+2-m. 

X f 00* Field k+2-m does not exist. 

X'nn" Field k+2-m contains the number of bytes specified (cannot 
exceed X»08 f ). 

BIND sender's LU name. 

Length of user data in field m+2-n. 

X'00 T Field m+2-n does not exist. 

X f nn* Field m+2-n contains the number of bytes specified. 
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Bvte Bits Value Opt Pi scussi on 

m+2-n X User data. 

m+2 X User data key. 

X'OO' X Structured subfi elds follow. 

-X'OO* X First byte of unstructured user data. 

Note: The unstructured user data continues in m+3 and goes to 
byte n. For information on structured subfi elds, see the BIND 
information in SNA Format and Protocol Reference Manual: Archi- 
tecture Logi c. 

n+1 Length of user request correlation field. 

X'OO' Field n+2-p does not exist. 

X'nn f Field n+2-p contains the number of bytes specified. 

n+2-p User request correlation field. 

P+l Length of BIND receiver's name in field p+2-r. 

X'OO' Field p+2-r does not exist. 

X'nn' Field p+2-r contains the number of bytes specified (cannot 
exceed X'08'). 

p+2-r BIND receiver's LU name. 



Definitions for Nonnegotiabla BIND 



The following definitions apply to bytes 14 to 25 of the nonnegotiable BIND 
request: 

1. LU-LU session type (byte 14): 

This f i eld speci f i es LU session type 4 and thus identifies the format 
and field definitions for bytes 15 through 25. 

2. BIND sendar to BIND receiver flow (bytes 15 to 18): 

This field defines the proposed session parameters for the BIND sender's 
send capability and, therefore, the BIND receiver's receive capability. 
Acceptance of the BIND by the BIND receiver means that these session 
parameters apply to thi s di recti on of transmission. 

3. BIND receiver to BIND sender flow (bytes 19 to 22): 

This field defines the proposed session parameters for the BIND receiv- 
er's send capabi li ty and, therefore, the sender's receive capability. 
Acceptance of the BIND by the BIND receiver means that these session 
parameters apply to this direction of transmission. 

4. Code selection (byte 23): 

The code selection repertoire (bits to 3) is not defined in the nonne- 
gotiable BIND. Any setting of bits in this field conveys no meaningful 
information. 

The code selection field (bits 4 and 5) defines the code for use in the 
session as the main code (that is, for an RU in which the code selection 
indicator in the RH i s set to B'0»). 

The code 1 selection field (bits 6 and 7) defines the code for use in the 
session as the alternate code (that is, for an RU in which the code 
selection indicator is set to B'l'). 

The code selection indicator in the request header (RH) allows for an 
individual RU to be represented in an alternate code. If the indicator 
is B'O', the main code is used; if B'l', the alternate code is used. For 
those RUs containing FM headers, the header is never subject to alter- 
nate codi ng. 

104 SNA — Sessions between Logical Units 



If alternate code is not to be used in the session (that is, if bit 4 of 
byte 6 of the BIND request is set to B'O'), then the code 1 selection 
field is meaningless. 

5. General characteristics (byte 24): 

This field defines general characteristics proposed for the session. 
Acceptance of the BIND by the BIND receiver means that these parameters 
apply to the session. 



NEGOTIABLE BIND REQUEST 



Allowable Allowable 
request response 



Bvte Bits 


sett i nqs 


setti nqs 


Di scussi on 


0-7 


X'31' 


X'31' 


BIND request 


1 0-3 
4-7 


X'O' 
X'O' 


X'O' 
X'O' 


Format 
Negotiable BIND 


2 0-7 


X'07' 


X'07' 


FM profile 7 


3 0-7 


X'07' 


X'07' 


TS profile 7 


FM Usaga 









BIND BIND 

Sender's Receiver's 

Send Receive 

Protocols Protocols 



B'l' Single and multiple element chains 

B'O' B'O' = Immediate request mode 
B'O', B'l' B'l* = Delayed request mode 

(Requires symmetric error recovery.) 

B'll' Definite or exception-only responses 

Reserved 

B'O', B'l' B'O' = BIND sender cannot send 

compressed data 
B'O', B'l' B'l' = BIND sender can send 

compressed data 

B'O' B'O' = BIND sender will not send EB 
B'O', B'l' B'l' = BIND sender can send EB 

BIND BIND 

Sender's Receiver's 

Receive Send 

Protocols Protocols 

B'l' B'l* BIND receiver sends single or multiple 

element chains 

1 B'O' B'O' B'O' = Immediate request mode 
B'l' B'O', B'l' B'l' = Delayed request mode 

(Requires symmetric error recovery.) 

2-3 B'll' B'll' Definite or exception-only responses 
4-5 Reserved 






B'l' 


1 


B'O' 
B'l' 


2-3 


B'll 


4-5 




6 


B'O' 




B'l' 


7 


B'O' 
B'l' 
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Request Response 
Byte Bits setti ngs setti ngs Pi scussion 

6 B'O' B f T B'O' = BIND receiver cannot send 

compressed data 
B'l' B'OSB'l' B'l» = BIND receiver can send 

compressed data 

7 B'O' B'O' B'O' = BIND receiver cannot send EB 
B'l' B»0',B'1 ! B'l' = BIND receiver can send EB 

6 Request Response Common Protocols for FM Data 
Setti ngs Setti ngs 

Reserved 

1 B'O' B'O' B'O' = FM headers not used 

B'l' B'O', B'l' B'l' = BIND sender and BIND receiver can 

exchange FM headers 

2 B'O' B'O' When brackets are used> bracket state 

manager's reset state is "in brackets." 

3 B'l' B'l' Bracket termination rule 1 

4 B'O' B'O' B'O' = Alternate code set will not be used 
B'l' B'O', B'l' B'l' = Alternate code set may be used 

5-7 Reserved 

Note: Byte 6 bit 3 is reserved if brackets are not 
used by the session. If brackets are not used and 
asymmetric recovery responsibility is indicated (byte 
7, bit 2)> then byte 7 bit 3 indicate^ uhirh w^in: 
partner is responsible for recovery. 



0-1 


B'10' 


2 


B'O' 




B'l' 


3 


B'O' 




B'l' 


4-6 




7 


B'l' 



nil i bii jcjjiuii 



B'10' Half-duplex flip-flop 

B'O', B'l' B'O' = Contention loser responsible 

for recovery (asymmetric recovery) 
B'l' B'l' = Symmetric recovery responsibility 

B'O' B'O' = BIND receiver is contention winner 

and BIND sender is contention loser 
B'O', B'l' B'l' = BIND sender is contention winner 

and BIND receiver is contention loser 

Reserved 

B'l' HDX-FF reset state is send for BIND sender 
and receive for BIND receiver 

Note: Byte 7 bit 3 is reserved if there is symmetric 
responsibility for recovery (when byte 7 bit 2=1) 
and brackets are not used. 



ts usaga 






8 


B'O' 
B'l' 


B'O' 
B'l' 


1 






2-7 


B'a' 


B'a' 



One-stage pacing 
Two-stage pacing 

Reserved 

BIND-recei ver CPMGR send pacing count 

Note 1: When the session involves a boundary 
function, pacing may occur in two stages. For the 
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Request Response 
Bvte Bits setti ngs setti ngs Pi scussion 

definition of a boundary function, see SNA Format and 
Protocol Reference Manual: Architecture Logic. 

Note 2: The meanings of and 1 are reversed from the 
staging indicator for BIND-sender CPMGR to 
BIND-receiver CPMGR (see byte 12). 

9 0-1 Reserved 

2-7 B'b' B'<b' BIND-receiver CPMGR receive pacing count 

Note; The BIND receiver may reduce the value, but it 
may not be reduced to zero unless the BIND receiver 
does not support pacing in the BIND sender to BIND 
receiver direction of flow. If this value is reduced 
and byte 12 bit is one, the BIND sender's send 
pacing count (byte 12 bits 2-7) must be reduced to the 
same value. 

10 0-7 X'ab' X'ab' Maximum RU size sent by the BIND receiver. 

The receiver cannot change the value. 
(See Appendix B for these values.) 

11 0-7 X'ab' X'<ab' Maximum RU size sent by the BIND sender 

(See Appendix B for these values.) 

Staging Indicator and Pacing Count for 
BIND sender to BIND receiver normal flow: 

12 B'O' B'O* Two-stage pacing 

One-stage pacing 

Reserved 

BIND-sender CPMGR send pacing count 

13 0-1 Reserved 

BIND-sender CPMGR receive pacing count 
(Byte 8 must equal byte 13 for 
single stage pacing.) 

14 B'O' B'O' PS usage field format is the basic format 

LU-LU session type 4 

BIND Sender to BIND Receiver Flow 

15 Printer Data Stream Profiles (DSPs) 

(B'O' = No support, B'l' = Supported) 

Base DSP 

General data stream 

Job data stream 

Reserved 

UP raw form data stream 

Reserved 

Note: Base DSP with NL and FF is part of all other 
printer DSPs. If bit = 0, no printer is supported 
on BIND receiver. If bit 1, 2, or 4 is set to 1, bit 
must be 1. 

16 Additional data stream profiles 

(X'00' = No additional media) 

(B'0' = No support, B'l' = Supported) 
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B'O' 
B'l* 


B'O' 
B'l' 


1 






2-7 


B'c' 


B'<c* 


0-1 






2-7 


B'd' 


B'd' 





B'O' 


B'O' 


1-7 


B'0000100' 


B'0000100 






B'O', B'l' 


B'O', B'l' 


1 


B'O', B'l' 


B'O', B'l' 


2 


B'O', B'l' 


B'O', B'l' 


3 


B'O' 


B'O' 


4 


B'O', B'l' 


B'O', B'l' 


5-7 


B'000' 


B'000' 





Request 


Response 




Bvte Bits 


settinqs 


settinqs 


Di scussi on 





B'0' 


B'0' 


Reserved 


1 


B'0',B'l* 


B'O'J'l 1 


Card 


2 


B'O' 


B'0' 


Reserved 


3 


B'CB'l' 


B'0',B'l' 


Basic exchange 


4 


B'0' 


B'O' 


Reserved 


5 


B'OSB'l' 


B'O' ,B'l' 


Word processing exchange diskette 


6 


B'0' 


B'O' 


Reserved 


7 


B'0' 


B'O' 


Reserved 



17 





1 

2 

3-7 



B'0',B'l' 
B'O', B'l' 
B'0',B'l' 
B'00000' 



B'O', B'l' 
B'O', B'l' 
B'O', B'l' 
B'00000' 



Console data stream profiles 

(B'O 1 = No support, B'l* = Supported) 

Base DSP (see Note) 
General data stream 
Job data stream 
Reserved 



Note; Base DSP with NL and FF is part of all other 
console DSPs. If bit = 0, no console is supported 
on BIND receiver. If bit 1 or 2 is set to 1, bit 
must be 1. 



18 




1-2 



B'O', B'l' 
B'nn' 



B'O' ,B'l* 

B'OSB'l' 
B'O' 



B'0',B'l' 
B'nn' 



B'0',B'1 ! 
B'0',B'l' 
B'O' 



FM and FMH 
(B'O' = No 



usage 
support, 



B'l' = Supported) 



Supervisory services FM data 

Destination-selection suspension stack 

(rin = 00 or 01 or 11; nn = 10 is 

reserved) 

Compacti on 

PDIR for all media 

Reserved 



B'OSB'l' 
B'0 ! ,B'l' 



B'O' 

B'l' 



BIND receiver need not receive CD on 
every EDS (end of destination selection) 
BIND receiver must receive CD on every EDS 



BIND Receiver to BIND Sender Flow 



19 






B'0', B'l' 


B'OSB'l' 


1 


B'0', B'l' 


B'OSB'l' 


2 


B'OSB'l' 


B'0', B'l' 


3 


B'0' 


B'0' 


4 


B'0» ,B'l' 


B'0', B'l' 


5-7 


B'000' 


B'000* 



Printer data stream profiles (DSPs) 
(B'0' = No support, B'l* = Supported) 

Base DSP 

General data stream 

Job data stream 

Reserved 

WP raw form data stream 

Reserved 

Note: Base DSP with NL and FF is part of all other 
printer DSPs. If bit = 0, no printer is supported 
on BIND sender. If bit 1, 2, or 4 is set to 1, bit 
must be 1. 



20 



Additional data stream 



B'0 
B'0 
B'0 
B'0 
B'0 
B'0 
B'0 
B'0 



,B'l' 
,B'l' 
,B'l' 



B'0 
B'0 
B'0 
B'0 
B'0 
B'0 
B'0 
B'0 



,B'l' 
,B'l' 
,B'l' 



prof i les 
media) 



(X'00' = no additional 

(B'0' = No support, B'l' = Supported) 

Reserved 

Card 

Reserved 

Basic exchange 

Reserved 

Word processing exchange diskette 

Reserved 

Reserved 
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Request Response 
Bvte Bi ts setti ngs setti ngs Pi scussi on 

21 Console data stream profiles 

CB'O' = No support, B'l 1 = Supported) 

B f T ,B'l T B'0»,B'l' Base DSP (see Note) 

1 B'0»,B'1» B f 0',B f l' General data stream 

2 B'O^B'l' B'0',B'l' Job data stream 
3-7 B f 00000» B'OOOOO 1 Reserved 

Note: Base DSP with NL and FF is part of all other 
console DSPs. If bit = 0, no console is supported 
on BIND sender. If bit 1 or 2 is set to 1, bit must 
be 1. 

22 FM and FMH usage 

CB'O 1 = No support, B'l 1 = Supported) 

B'OSB'l' B^SB*!' Supervisory services FM data 
1-2 B'nn' B'nn 1 Destination-selection suspension stack 

(nn = 00 or 01 or 11; nn = 10 is 
reserved) 

3 B f 0',B f l f B'0',B'1» Compaction 

4 B'0',B'l' B'0',B'l' PDIR for all media 

5 B'0 f B'0 1 Reserved 

6 B , , ,B , 1» B'OSB'l' QUERY FOR DATA SET FMH-2 

7 B'OSB'l* B'O 1 B T f = BIND sender need not receive CD on 

every EDS (end of destination selection) 
B'OSB'l' B'l' B'l 1 = BIND sender must receive CD on every EDS 

23 Code selection 

(B'0 1 = No support, B*l f = Supported) 

0-3 Repertoire 

B f T ,B f l' B'0',B'l' EBCDIC 

1 B'CB'l' B'0',B'l' ASCII or ISCII or ITA 5 
2-3 B'0 f B'0* Reserved 

4-5 B'nn 1 B'nn* Code (main code) selection. 

(nn = 00 (EBCDIC) or 01 (ASCII); 

other values reserved) 
6-7 B'nn* B^n" Code 1 (alternate code) selection. 

(nn = 00 (EBCDIC) or 01 (ASCII); 

other values reserved) 

24 General characteristics 

0-1 B'00» B'00' Reserved 

2 B f 0» B'CB'l' B'0' = BIND sender may send data first 
B'l 1 B'O'.B'l 1 B'l* = BIND receiver must send data 

first 

3 B'O* B f 0» Reserved 

4 B»0',B'l' B f 0» B f 0» = BIND sender/receiver will 

initiate attended mode 
B'OSB'l' B'l f B f l f = BIND sender/receiver will 

initiate unattended mode 

5 B , T ,B , l f B'O 1 B'O 1 = BIND sender/receiver will not alternate 

between attended and unattended mode 
B f , ,B , l» B f l f B'l' = BIND sender/receiver may alternate 

between attended and unattended mode 
6-7 B'00* B'00' Reserved 

25 Reserved 
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Cryptography Options 



Request Response 
Bvte Bits setti nos setti ngs 



26 



0-1 



2-3 



4-7 



27 0-1 

2-4 
5-7 

28-k 



B'00' 
B'01' 
B'10' 
B'll' 



B'00' 
B'01' 

B'10' 
B'll' 



X'O' 
X'9' 



B'00' 
B'000' 

B'000' 



B'00' 

B'00', B'01' 
B'00',B'10» 
B'00' 



B'00' 

B'00', B'01' 
B'00' 
B'00', B'01' 



X'O' 
X'9' 



B'00' 
B'000' 

B'000' 



Opt 



Pi scussi on 

An X in OPT column indicates value is optional. 

Private cryptography options: 

No private cryptography supported 

Private cryptography supported 

Reserved 

Reserved 

Note; BIND receiver must accept sender* s choice 
of cryptography or return B'00*. 

Session-level cryptography options: 

No session-level cryptography supported 

Session-level selective cryptography supported 

Reserved 

Session-level mandatory cryptography supported 

Session-level cryptography 

options field length: 

No session-level cryptography specified 

Session-level cryptography specified 

Session cryptography key encipherment mode: 
Key enciphered under BIND receiver key 

Reserved 

Cryptography cipher method: 
Block chaining 

Session cryptography key enciphered 
under BIND receiver master key 



Names and End User Data 



Request 
Bvte Bits setti ngs 



k+1 

k+2-m 
m+1 

m+2-n 
n+1 

n+2-p 
P+l 

p+2-r 



X'00' 
X'nn' 



X'00' 
X'nn' 



X'00' 
X'nn' 



X'00' 
X'nn' 



Response 
setti ngs 



X'00' 
X'nn' 



X'00' 
X'nn' 



X'00 



Pi scussi on 

Length of BIND sender's name in field k+2-m 

Field k+2-m does not exist 

Field k+2-m contains X'nn' bytes (<X'08 f ) 

BIND sender's LU name 

Length of user data in field m+2-n 

Field m+2-n does not exist 

Field m+2-n contains number of bytes specified 

User data (response same format as request) 

Length of user request correlation field 
Field n+2-p does not exist 



X'mm'>X'00' Field n+2-p contains number of bytes specified 
User request correlation field 



X'00' 
X'nn' 



Length of BIND receiver's name in field p+2-r 

Field p+2-r does not exist 

Field p+2-r contains X'nn' bytes (<X'08») 

BIND receiver's LU name 
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Definitions for Negotiable BIND 

The following definitions apply to bytes 14 to 25 of the negotiable BIND 
request: 

1. LU-LU session type (byte 14): This field specifies LU session type 4 
and thus identifies the format and field definitions for bytes 15 
through 25. 

2. BIND sender to BIND receiver flow (bytes 15 to 18): 

BIND sender's send capabilities (negotiable BIND request). This field 
provides information that assists the session partner in identifying the 
range of send capabilities that may be desired. The session partner 
should use this information when deciding how to adapt to these capabil- 
ities; the information may not be used to reject session activation. 

BIND receiver's receive capabilities (negotiable BIND response). This 
field defines the session parameters that are acceptable for this direc- 
tion of flow. Acceptance of the session activation means that the BIND 
sender will comply with the BIND parameters for this direction of flow. 

3. BIND receiver to BIND sender flow (bytes 19 to 22): 

BIND sender's receive capability (negotiable BIND request). This field 
defines the session parameters that arG proposed for this direction of 
flow. The session partner may use this information in preparing the 
BIND response; the information may not be used to reject session acti- 
vati on. 

BIND receiver's send capability (negotiable BIND response). This field 
defines the range of session parameters that may be used in this direc- 
tion of flow. Acceptance of session activation means that the BIND 
sender will comply with these parameters for this direction of flow. 

4. Code selection (request and response) (byte 23). 

In the BIND request, the BIND sender specifies both the main (code 0) 
and alternate (code 1) codes proposed for use in the session. If the use 
of alternate code is not proposed (that is, if bit 4 of byte 6 of the 
BIND request is set to B'0')> then the code 1 selection field is mean- 
ingless. The BIND sender also indicates his code repertoire to assist 
the BIND receiver in identifying a mutually compatible code if 
multiple-code capability exists. 

5. The capability to send, to receive, or to prohibit FM data in the super- 
visory services session is supported. In the case of a 
terminal-to-terminal or clustei — to-cluster session, these supervisory 
services are provided by the LUs. In a system managed by an SSCP, the 
SSCP provides these services to the LUs. 

6. LU_T4 uses FMH-1 to control the beginning and ending of destination 
selection. Optionally, LU_T4 uses FMH-2 to process data at the active 
destination, and FMH-3 to send a compaction table for use by all LU 
components. Complete definitions of these headers and subsets supported 
are found in Part 2 Chapter 4 and under "FM Header Processing" in this 
chapter . 

7. Support of compaction is optional. This indicator applies only to SCB 
compacti on. 

8. Support of the PDIR FMH-2 is optional. When supported, it applies to 
all media. 

9. QUERY FOR DATA SET FMH-2 allows one LU to solicit input from the other's 
various sources: card, disk, and so on. 

10. General characteristics (request and response) (byte 24). 

This field specifies additional session parameters that may be required 
by the session partners. If a conflict arises between the BIND sender 
and BIND receiver, the BIND response will resolve the conflict. 

11. A console is optional for LU_T4. 
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The BIND receiver must adapt to the code selection in the BIND request as 
follows (applicable to products with multiple-code capability): 

1. If the main code proposed in the BIND request exists in the repertoire 
of the BIND receiver, then the proposed main code must be accepted and 
such acceptance is indicated in the BIND response by the appropriate 
setting of the code selection field. 

2. If the main code proposed in the BIND request does not exist in the 
repertoire of the BIND receiver, a comparison is made with the code 
repertoire indicated in the BIND request. If any (one or more) mutually 
compatible code(s) exist, the BIND receiver specifies the main code to 
be used for the session by an appropriate setting of the code 
selection field in the BIND response. The order of preference of this 
code selection is, first, that code specified in bit of the code 
repertoire, followed in order by those codes specified by bits 1, 2, and 
3. 

3. If the BIND sender proposes that alternate code not be used, the BIND 
receiver must set bit 4 of byte 6 to B'O* in the BIND response. This 
makes the code 1 selection field meaningless. 

4. If the BIND sender proposes that alternate code be used, and if that 
proposed alternate code exists in the repertoire of the BIND receiver, 
then the BIND receiver accepts the proposed alternate code by the appro- 
priate setting of the code 1 selection field of the BIND response. 
Otherwise, the BIND receiver specifies that alternate code is not to be 
used by setting bit 4 of byte 6 to B'O* in the BIND response. 

Thus, the code selection to be used in the session is defined as being 
specified in the BIND response. 
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Type 6 LU-LU sessions are used for data communication between transaction 
processing systems (TPSs). The TPSs then provided functions that permit 
application programmers to develop transaction processing applications in 
which different parts of the application are performed at different TPSs. 

The TPSs are interconnected via type 6 LU-LU sessions, and they provide two 
major services: 

• They allow resources, such as files and queues, to be distributed through- 
out the network, and provide a means for easily accessing such resources 

• They allow application programs, called transaction processing programs, to 
be distributed throughout the network, and provide a means for these trans- 
action processing programs to communicate and cooperate with each other in 
processing transactions. 

These two services are discussed in greater detail in SNA Concepts and 
Products as the remote resource access capability and the TPP (transaction 
processing program) conversational capability. 

An example of an LU_T6 session is where one CICS/VS and one IMS/VS system are 
in session; a CICS/VS application program may communicate with an IMS/VS 
program. LU_T6 implementations use the term transacti on to describe this 
type of communication between programs. Transactions are usually of short 
duration? the longer batch and interactive sessions are not precluded, howev- 
er. 

Within type 6 sessions, many transactions may occur on the session between 
TPSs. In this sense, a transaction is a unit of work initiated by a single 
request. Where the work is accomplished is determined by where the end user 
placed the transaction processing programs within the network. 

In some cases, the location of the data (local or remote) becomes transparent 
to the programs. The programs can obtain access to remote data without issu- 
ing a unique transaction to the target system to access the data. The TPSs 
convert these requests to a standardised format and forward them to the 
appropriate TPS following the session's protocol rules. 

LU-T6 sessions operate in a network controlled by one or more SSCPs. The 
half-sessions operate in a symmetric environment; that is, the partners are 
equals and neither controls the session. The half-session that sends the 
data assumes error recovery responsibility for the data. 

The session begins when one TPS sends a BIND SESSION request to the desired 
session partner (another TPS). The BIND SESSION request identifies those 
functions the BIND sender wishes to use. The request may be a negotiable 
BIND. The BIND receiver can agree to the session parameters and return a 
positive response to BIND that is identical to the one received. If the BIND 
receiver wishes to negotiate, however, it returns a positive response to BIND 
that shows the changed parameters. 

LU_T6 implementations need not contain all functions of the LU_T6 protocol. 
By using BIND SESSION, implementations can determine whether there is a 
subset of functions that allows meaningful communication between session 
partners. 



HALF-SESSION CHARACTERISTICS 



FM, TS, AND PS PROFILES 



LU_T6 implementations use FM profile 18 and TS profile 4. The SNA requests 
that Qre allowed with each profile are found in SNA Reference Summary. 
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LU_T6 implementations use a PS profile that allows the following function 
management header and data stream options: 

Function Management Headers (FMHs). LU_T6 implementations may use these FM 
headers: 

• FMH-4 - This header is used to carry a logical block command and associated 
information for logical message services (LMS), an end-user service that 
can be implemented by TPSs. Logical message services uses LU-T6 sessions 
to transmit messages between end users. 

• FMH-5 - This header is used to select a named transaction program wi thin the 
receiving LU. FMH-5 flows from the transaction processing program using 
the sending half-session to the LU services manager for the receiving 
half-session. The transaction processing program must use FMH-5 to identi- 
fy a named transaction program if the default destination at the receiving 
half-session is inappropriate or not provided. 

• FMH-6 - This header is used to carry a command or data, or both, from an 
active transaction program attached to the sending half-session to an 
active transaction program attached to the receiving half-session. 

• FMH-7 - This header is used to send further information about an error after 
negative response X'OS^ 1 has been received. 

• FMH-10 - This header is used to start sync point processing. The LU 
services manager for the sending half-session sends the FMH-10 to the LU 
services manager for the receiving half-session. 

Function management headers are discussed further in "Part 2 Chapter 4: Func- 
tion Management Headers." 

Data Streams. The session partner that sends the ATTACH FMH-5 selects the 
data stream. The data streams used by LU_T6 sessions are defined by the user. 

TC [TRANSMISSION CONTROL) CONSIDERATIONS 

Transmission Control services, such as pacing and cryptography, are summa- 
rised in SNA Concepts and Products and defined in SNA Format and Protocol 
Reference Manual: Architecture Logic. 

DFC (DATA FL014 CONTROL) CONSIDERATIONS 

Data flow control services, such as chaining, brackets, and send/receive 
modes, are summarized in SNA Concepts and Products and defined in SNA Format 
and Protocol Reference Manual : Architecture Logic. The following paragraphs 
give additional considerations. 

SEND-RECEIVE MODES 

LU_T6 implementations use half-duplex flip-flop. A half-sessi on' s reset 
state is either send (-BETB .SEND. BETC with attributes S,-R) or receive 
(-BETB.RCV.BETC with attributes -S,R) when the bracket reset state is INB. A 
half-session's reset state is BETB .RCV.BETC with attributes -S,R when bracket 
reset state is BETB. 



BRACKET PROTOCOL 

LU_T6 implementations use the bracket protocol defined in SNA Format and 
Protocol Reference Manual : Architecture Logic. The BIND SESSION option that 
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allows neither half-session to end a bracket is invalid; that is byte 4 bit 7 
and byte 5 bit 7 cannot both be B'0 T . The BIND receiver can reject the BIND 
if optional bracket settings are not supported; it must support the required 
setti ng. 

Transactions cannot span brackets. 



CHANGE-DIRECTION MANAGEMENT 



Use of CD Indicator (CDI): The change direction indicator (CDI) in the 
request header (RH) is used to change the direction of data flow when session 
partners are using half-duplex flip-flop mode and are in brackets (after BB 
and before EB). The session partner that has the authority to send at a given 
moment changes the direction of flow by turning on the CDI in the last RU it 
chooses to send. 

The sending of the CDI should occur under the following circumstances: 

• A transaction program has reached an end-of-send data-transition condition. 

• A transaction program has received SIG X'0001' (request change direction). 
The procedures that must be followed when returning the CDI are discussed 
below under "Signal Codes." 

• A transaction program has been session-activated in the send state* but has 
no data traffic to send. 

• When the transaction program receives CD and it doesn't have any data to 
send. 

A transaction program should send available FM data, if any, when the CDI is 
recei ved. 

Use of SIG (Signal): An LU that is capable of sending FM data may choose to 
send SIG X'OOOl' (request change direction) when in receive state with FM 
data to send. 

The sender of SIG X'OOOl 1 is not required to return the CDI when it has no 
more data to send. 

The receiver of SIG X'OOOl 1 should not send SIG X'OOOl' after sending the CDI 
until the end-chain indicator (ECI) has been returned. This prevents a 
signal ping/pong condition from occurring with no data flowing. 

Data Direction Resolution: If brackets are used, the LU designated as the 
contention loser (BIND byte 7, bit 3) normally sends a BID request if it wants 
to enter send state, but it may enter send state by sending data to the 
session partner if that data is sent requiring a definite response (BB,RQD). 
The LU designated at the contention winner (first speaker) enters send state 
by sending data to the PLU. 



PS (PRESENTATION SERVICES) CONSIDERATIONS 



FM HEADER PROCESSING 

After a session has been activated between two LUs, transaction processing 
programs can begin using the session. An ATTACH FMH-5 is sent between LUs 
before the sending transaction processing program sends data to the receiving 
transaction processing program. The ATTACH FMH-5 contains the name of the 
receiving program and other information needed to exchange data. LU_T6 
implementations may choose to have a default destination if data is received 
without an ATTACH FMH-5. 

Once the receiving program has been attached, other FM headers are valid if 
appropriate for the application or TPS. 
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DATA STREAM PROFILES 



LU_T6 implementations specify the usei — defined data stream profile in the 

ATTACH FMH-5. 



SIGNAL CODES 



SIG is an expedited request that may be sent between half-sessions regardless 
of the normal flows. It carries a 4-byte signal code set by the sending LU. 

One signal code is valid for LU__T6: 

X'0001' + ''rrrr 1 Request to send (0001) and reserved field (rrrr). 

Signal codes that are not recognized or cannot be handled may be rejected 
with a negative response (sense code X'lOOS* function not supported). 



LU STATUS (LUSTAT) CODES 



Two LUSTAT codes must be received by LU_T6 half-sessions: 

0006 Request header bit carrier 

0007 Sender currently has no FM data requests to transmit 

The format of LUSTAT is: 

Byte Value Definition 

X*G4* Request code 

1-4 Status value and status extension field 

(two bytes each) 

X* 0006 f +* rrrr ' No-op except to allow an RH to be sent when 

no other request is available or allowed (0006) 
and reserved field (.rrrr'i 

X T 0007 ' + * rrrr' Sender currently has no FM data to transmit 
(0007) and reserved field irrrr'i 

LU_T6 allows BB (begin bracket) on LUSTAT. 



SYNC POINTS 



LU_T6 implementations provide a protocol for coordinating events between two 
cooperating transaction processing programs. Under this protocol, the 
programs establish periodic synchronisation points. When a synchronization 
point is reached, both TFSs are notified that all work since the last 
synchronization point has been successfully completed. If the conversation 
between the two transaction processing programs is disrupted before a 
synchronization point is reached, both TPSs cancel data base changes made 
since the previous synchronization point, so that files used by both trans- 
action processing programs will be at the same level. 



ERRORS 



All errors are turned into exception requests (EXRs) by the element of the 
network that detects the error. The exception request is sent forward 
(except for loss of path errors) to the destination identified by the DSAF 
and DAF (destination subarea f i eld and desti nati on address field of the tran- 
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smission header). The destination then processes the EXR and returns a nega- 
tive response if the request was marked definite or exception response 

requested. 



ERP TRANSITION 

An error may be detected while a half-session is sender or receiver and while 
multiple requests are outstanding. To ensure an orderly transition to ERP 
state by both half-sessions, the following rules are used. 

Note: There are several levels of synchronization on an LU_T6 session. The 
level discussed here is the synchronizing of RU chains. Examples of other 
levels are brackets synchronization and transaction program unit-of-work 
synchronization. 

For sender detected errors: 

1. The session partners may already be synchronized. This condition occurs 
if no RU chains have been sent since the receipt of CD or if a positive 
response has been received to the last chain sent. If the last chain was 
sent RQD, then synchronization is achieved by waiting for the response. 

2. If the last chain was sent RQE, then CHASE is sent to achieve synchroni- 
zat i on. 

3. If the current chain is incomplete, then CANCEL is sent to achieve 
synchronization. 

For receiver detected errors: 

1. If there is an outstanding RU chain, then the receiver sends negative 
response X'0846 t unless there is an inescapable transition to BETB (BB,EB 
or EB,RQE chain), in which case a more informative code may be used. (See 
"Sense Codes and Sense Data" on page 118). 

2. If there is no outstanding chain (error detected subsequent to response), 
then the receiver sends negative response X'0846 1 to the next chain. 
This action avoids compounding the error situation by attempting to use 
Signal (RCD). 

3. Once a negative response has been sent, RQE chains are purged to achieve 
synchronization. Each nonsynchroni zi ng chain is discarded without 
response. Responses to the possible synchronizing events are: 

Synchronizing event Response 

RQE, CD -RSP.0867 

RQD FM data -RSP.0867 

DFC(LUSTAT),RQD -RSP.0867 

DFC(-LUSTAT),RQD +RSP 

Negative response X'0867' is used to reduce the possibility of a transition 
to BETB with resulting loss of ERP coordination. 

LUSTAT is the only DFC request that allows a negative response. The positive 
response to DFC(-LUSTAT) signifies to both half-sessions that purge state has 
been exited and that the ERP message can flow. 

Note: The possibility of asynchronously detected errors leads to the possi- 
bility of contention for ERP. SEND. This condition is manifested by the 
receipt of negative response X'0846' while purging, and this response ovei — 
rides the current purging operation. 

SENDER ERP BUT WITH SELECTIVE RECEIVER ERP 

LU_T6 sessions require that the session partners use sender ERP; that is, the 
sender of data is responsible for error recovery of that data. Under this 
protocol, the receiver remains in receive state after it sends a negative 
response unless it entered BETB state. The sender of data then attempts to 
correct the error and synchronize the session. 
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There are times when the receiver of data can provide valuable information 
about the error, but it cannot contain the information within the sense data 
field of the negative response. When this condition occurs, sense code 
X'0846' is returned with the negative response- This alternati ve allows the 
data receiver (the sender of the negative response) to choose when to change 
the normal send-receive (S,R) transitions. 

If the data receiver returns negative response X T 0846', it must follow the 
response with an ERP message. 



ERP Hassagas 



ERP messages are requests used by the session partners to define the cause of 
errors and to provide corrective information. The request unit that carries 
the ERP message contains an FH header type 7 (FMH-7) and the ERP message, 
which can be any information understood by the session partners: 

< RU > 



RH 


FMH-7 


ERP message 



The traditional SNA method of notifying the session partner of an error is 
the negative response returned by the receiver when an error is detected. 
Within LU_T6 sessions, the ERP message provides session partners with an 
alternative protocol. 



SENSE CODES AND SENSE DATA 



Sense code values for LU_T6 sessions are 
CHAIN ERRORS; 



RH usage errors: X*40 T 



4003 
4009 



BB not allowed 
CD not allowed 



Request errors: X'10 T 

10030000 Function not supported 

10036002 Invalid destination program name (DPN) 

10036003 Invalid primary resource name (PRN) 
100S0000 Invalid FM header 

100S200E Invalid concatenation 

10086001 Invalid deblocking algorithm (DBA) 

10086004 Invalid queue name length 

10086006 Invalid data stream profilp (DSP) 

10086007 FMH-7 not preceded by negative response X'0846* 

10086008 Invalid attach access code 

10086009 FMH-5 fixed length parameter count not equal to 2 
1008600A Not first FMH-5 and IUT -= IUT in register and IUE 
100S600B FMH-5 command invalid 

100860CC Null sequence field required 

1008600D User to user program transition not allowed 

1008600E User to architected program transition not allowed 

100S600F RAP FMH-5 not sent properly 

10086010 RAP FMH-5 sent with inactive attach register 

Request Reject: X T 08 f 

080F End user not authorised 

0812 Insufficient resource 

0813 Bracket BID reject — no RTR forthcoming 

0814 Bracket BID reject - RTR forthcoming 
0819 RTR not required 



-- on 
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081C Request not executable 

0826 FM function not supported 

0829 Change direction required 

084B000O Requested resource not available 

084B6002 Requested DPN resource unavailable 

084B6003 Requested PRN resource unavailable 

UNIT OF WORK ERRORS; Unit of work errors are request reject errors (category 
code X'08»): 

0824 Unit of work aborted 

0846 ERP message forthcoming 

0864 Function abort — loop will occur upon reexecution 

0865 Function abort — sender responsible to detect loop 

0866 Function abort — receiver responsible to detect loop 

X , 0846 l is used to cause a transition from sender ERP to receiver ERP. 
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0-7 


X'31* 


1 


0-3 


X f 0» 


(1) 


4-7 


X'0» 
X'l* 



BIND SESSION FORMAT FOR LU-LU SESSION TYPE 6 

This section defines valid bit settings for the BIND request. The BIND for 
LU__T6 can be sent as a negotiable or nonnegotiable request. In a negotiable 
BIND, the BIND sender and BIND receiver can negotiate to establish session 
protocols. In the nonnegotiable BIND, the BIND sender specifies the session 
parameters. 

The formats of both the nonnegotiable BIND and the negotiable BIND request 
and response are identical. Differences in protocols are noted in the field 
def i ni ti ons. 



BIND SESSION REQUEST 

This section defines valid bit settings for the BIND request. All values 
listed must be supported, unless the value is optional (identified by P i n 
the Opt column for the BIND sender and by S i n the Opt column for the BIND 
receiver) or not valid. 

Bvte Bi ts Value Opt Pi scussi on 

Identifies this RU as a BIND request. 

Specifies the format of the BIND RU. Only one format has been 
defined: format (zero). 

Type - denotes the type of BIND to be performed: 
Negotiable BIND (cold start) 
Nonnegotiable BIND (cold start) 

FM (Function Management) Profile 

2 0-7 X'12' FM profile 18 

The FM profile defines data flow control (DFC) protocols. (See 

SNA Reference Summary for highlights of the FM profile.) 

TS (Transmission Subsystem) Profile 

3 0-7 X'04' TS profile 4 

The TS profile defines transmission control (TO protocols. 
(See SNA Reference Summary for highlights of the TS profile.) 

FM Usage 

(4-7) See bytes 4 through 7 below. 

BIND Sender's Send Protocols 

Chaining Use: 

4 B'O* Not valid 

B'l" BIND sender can send single or multiple element chains. 
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Byte Bi ts Value Opt Pi scussion 

Request Mode Selection: 

(4) 1 B'O' Immediate request mode is used. Only one definite response can 

be outstanding at a time. That response must be received before 
the BIND sender can send another RU. 
B'l' P Delayed request mode is used. Multiple definite responses can 
be outstanding at one time. 

Note: If delayed request mode is used, the RU sender must be 
responsible for recovery, and EC (end chain) may not be sent on 
the current chain when a definite response is outstanding for 
the previous chain. 

Chaining Responses: 

(4) 2-3 B'OO' Not valid 
B'01' Not valid 

B'10' P BIND sender can request only definite responses. 
B'll* BIND sender can request definite or exception responses. 

Two-phase Commit Indicator: 

(4) 4 B'O' Two-phase commit not supported (cannot send PREPARE FMH-10). 
B'l' P Two-phase commit supported (can send PREPARE FMH-10). 

(4) 5 Reserved 

Compression Indicator: 

(4) 6 B'O' BIND sender cannot send compressed data. 
B'l' Not valid. 

Send End Bracket Indicator: 

(4) 7 B'0 T BIND sender will not send EB (see byte 6 bit 2). 

B'l f BIND sender can send EB. 

Note: First speaker must be able to send EB (see byte 7 bit 3). 
If BIND sender is first speaker, bit 7 must be 1. 

BIND Receiver's Send Protocols 

Chai ning Use: 

5 B'0» Not valid 

B'l' BIND receiver can send single or multiple element chains. 

Request Mode Selection: 

(5) 1 B'O' Immediate request mode is used. BIND receiver can issue a 

request for a single definite response. No further transmission 
is sent until the BIND receiver receives the requested response. 
B'l' S Delayed request mode is used. BIND receiver allows several 
definite responses to be outstanding at one time. 

Note: If delayed request mode is used, the RU sender must be 
responsible for recovery. 

Chaining Responses: 

(5) 2-3 B'OO' Not valid 
B'01' Not valid 

B'10' S BIND receiver can request only definite responses. 
B'll' BIND receiver can request either definite or exception 
responses. 
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(5) 


4 


B'O' 
B'l' 


(5) 


5 





Byte Bits Value Opt Pi scussi on 

Two-phase Commit Indicator: 

Two-phase commit not supported. 
S Two-phase commit supported. 

Reserved 

Compression Indicator: 

(5) 6 B'O' BIND receiver cannot send compressed data. 
B'l' Not valid. 

Send End Bracket Indicator: 

(5) 7 B'O' S BIND receiver will not send EB (see byte 6 bit 2). 

B'l' BIND receiver can send EB. 

Note: First speaker must be able to send EB (see byte 7 bit 3). 
If BIND receiver is first speaker, bit 7 must be 1. 

Common Protocols for FM Data 

6 Reserved 

(6) 1 B'O' Not valid. 

B'l* BIND sender and BIND receiver can exchange FM headers. 

Brackets Usage and Reset State: 

Note: Brackets are required in LU_T6 sessions. 

(6) 2 B'O* The bracket state manager's reset state is INB (in brackets). 

B'l' The bracket state manager's reset state is BETB (between brack- 
ets) . 

Bracket Termination Rule Selection: 

(6) 3 B'O' Not valid 

B'l* Bracket termination rule 1 is used. 

Note: Bit 3 is reserved if brackets are not used by the 
sessi on. 

Alternate Code Selection: 

(6) 4 B'O' Alternate code set may not be used. 
B'l 1 Not valid. 

Sequence Number Usage for Resynchroni zati on: 

(6) 5 B'O' Sequence numbers not available. 

B'l' Sequence numbers available (from the previous activation of the 
session with the same session name) for sync point resynchroni - 
2ati on. 

Bracket State Status for Resynchroni zati on: 

(6) 6 B'O' BIS request not sent prior to session termination. 

B'l' BIS request sent prior to session termination (from the previous 
activation of the session with the same session name) so 
sequence numbers are not required for resynchroni zati on. 

(6) 7 Reserved 
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Bvte Bi ts Value Opt Pi scussi on 

Normal-Flow Send and Receive Mode Selection: 

7 0-1 B'00' Not valid 

B'01' Not valid 

B'10 1 Half-duplex flip-flop 

B'll' Reserved 

Recovery Responsibility: 

(7) 2 B'O' Not valid. 

B'l' Symmetric responsibility for recovery. The sender of data is 
responsible for recovery. 

Contention Winner/Loser: 

(7) 3 B'O* BIND receiver is contention winner (first speaker) , and BIND 

sender is contention loser. 
B'l' PS BIND sender is contention winner (first speaker), and BIND 
receiver is contention loser. 

(7) 4-6 Reserved 

Half-Duplex Flip-Flop (HDX-FF) Reset States: 

Note: Byte 7 bit 7 is reserved if bracket state manager reset 
is BETB; it is used only when reset is INB (see byte 6 bit 2). 

(7) 7 B'O' HDX-FF reset state is RECEIVE for the BIND sender and SEND for 

the BIND receiver (that is, the BIND receiver sends normal-flow 
requests first after session activation or reset). 
B'l' HDX-FF reset state is SEND for the BIND sender and RECEIVE for 
the BIND receiver (that is, the BIND sender sends normal-flow 
requests first after session activation or reset). 



TS Usagq 

(8-13) See bytes 8 through 13 below. 

Staging Indicator and Pacing Count for BIND-recei ver CPMGR 
(connection point manager) to BIND-sender CPMGR normal flow: 

8 B'O' Pacing in this direction occurs in one stage. 

B'l' Pacing in this direction occurs in two stages. 

Note 1: When the session involves a boundary function, pacing 
may occur in two stages. (For the definition of a boundary 
function, see SNA Format and Protocol Reference Manual: Archi- 
tecture Logi c. ) 

Note 2: The meanings of and 1 are reversed from the staging 
indicator for BIND-sender CPMGR to BIND-recei ver CPMGR (see 
byte 12). 

(8) 1 Reserved 

(8) 2-7 B'nnnnnn' BIND-recei ver CPMGR's send pacing count. A value of 000000 

means no pacing of requests flowing from the BIND receiver. 

9 0-1 Reserved 

(9) 2-7 B'nnnnnn' BIND-recei ver CPMGR's receive pacing count. A value of 000000 

causes the boundary function to substitute the value set by a 
system definition pacing parameter (if the system definition 
includes such a parameter) before it sends the BIND RU on to the 
BIND receiver. A value of 000000 received at the BIND receiver 
is interpreted to mean no pacing of requests flowing to the BIND 
receiver. 
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Byte Bi ts Value Opt Pi scussi on 

Maximum RU Size: 

10 X'85* Maximum RU size of 256 bytes sent on the normal flow by the BIND 

receiver. 
X'ab' P Maximum RU size greater than or less than 256 bytes. 

This value represents the largest RU that can be sent. It i s 
expressed as a mantissa and an exponent value of 2 by which the 
mantissa is multiplied. For example, when the mantissa is 8 and 
the exponent is 5 (X'85'), the RU size is 256 bytes (8 x 2 5 ). 

When bit is set to zero> no maximum is specified, and the 
remaining bits 1-7 are ignored. When bit is set to one, the 
byte is interpreted as X'ab f . (See Appendix B for these 
values. ) 

11 X'85' Maximum RU size of 256 bytes sent on the normal flow by the BIND 

sender. 
X'ab' S Maximum RU size greater than or less than 256 bytes. 

This value represents the largest RU that can be sent by the 
BIND sender and is specified in the same format as the BIND 
receiver (byte 10). 

Staging Indicator and Pacing Count for BIND-sender CPMGR to 
BIND-recei ver CPMGR normal flow: 

12 B'O' Pacing in this direction occurs in two stages. 

B'l' Pacing in this direction occurs in one stage. 

Note: The meanings of and 1 are reversed from the staging 
indicator for BIND-recei ver CPMGR to BIND-sender CPMGR (see 
byte 8, notes 1 and 2). 

(12) 1 Reserved 

(12) 2-7 B'nnnnnn' BIND-sender CPMGR's (connection point manager's) send pacing 

count. A value of 000000 means no pacing of requests flowing 
from the BIND sender. 

For single-stage pacing in the BIND sender to BIND receiver 
direction, this field is redundant with, and will indicate the 
same value as, the BIND-recei ver CPMGR's receive pacing count 
(see byte 9, bits 2-7 above). 

13 0-1 Reserved 

(13) 2-7 B'nnnnnn* BIND-sender CPMGR's receive pacing count. A value of 000000 

means no pacing of requests that flow to the BIND sender. For 
single-stage pacing in the BIND receiver to BIND sender direc- 
tion, this field is redundant with, and will indicate the same 
value as, the BIND-recei ver CPMGR's send pacing count (see byte 
8, bits 2-7 above). 

PS Profile 

(14-25) See bytes 14 through 25 below. 

14 B'0' PS usage field format is the basic format. 

B'l' Reserved 

(14) 1-7 B'0000110' LU-LU session type 6 
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Bvte Bi ts Value Opt Pi scussi on 
PS Usage 

15 Reserved 

16-19 BIND Sender Flags: 

16 0-1 Reserved 

2 8*0' System message transaction program not supported 
B'l' P System message transaction program supported 

3 B'O' Scheduler transaction program not supported 
B'l' P Scheduler transaction program supported 

4 B'O' Queue transaction program not supported 
B'l' P Queue transaction program supported 

5 Reserved 

6 B'O' DL/1 transaction program not supported 
B'l' P DL/1 transaction program supported 

7 Reserved 

17-19 Reserved 

20-23 BIND Receiver Flags: 

20 0-1 Reserved 

System message transaction program not supported 
System message transaction program supported 
Scheduler transaction program not supported 
Scheduler transaction program supported 
Queue transaction program not supported 
Queue transaction program supported 
Reserved 

DL/1 transaction program not supported 
DL/1 transaction program supported 
7 Reserved 

21-23 Reserved 

24-25 Reserved 

Cryptography Options 

26 0-1 Private cryptography options: 

B'00' PS No private cryptography supported. 

B'01' PS Private cryptography supported. The session cryptography key 

and cryptography protocols are privately supplied by the end 

user. 
B'10' Reserved 
B'll' Reserved 

(26) 2-3 Session-level cryptography options: 

B'00' PS No session-level cryptography supported. 

B'01' PS Session-level selective cryptography supported. All cryptogra- 
phy key management is supported by the SSCP and LU; exchange 
(using +RSP to BIND) and verification (using CRV) of the cryp- 
tography session-seed value are supported by the LUs for the 
session. All FM data requests with EDI (enciphered data indica- 
tor) on are enciphered/deciphered. 

B'10' Reserved 

B'll* PS Session-level mandatory cryptography supported; same as 
session-level selective cryptography except all FM data 
requests are enciphered/deciphered. 

(26) 4-7 Session-level cryptography options field length: 

X'0' PS No session-level cryptography specified. The cryptography 
option fields (bytes 27-k) are omitted. 
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Bvte Bi ts Value Opt Pi scussi on 

X'9' PS Session-level cryptography specified. Additional options 
follow in the next nine bytes. 

27 0-1 Session cryptography key enci pherment mode: 

B'OQ' PS Session cryptography key enciphered under BIND receiver (or 
SLU) master cryptography key using a seed value of zero (only 
value defined). 

(27) 2-4 Reserved 

(27) 5-7 Cryptography cipher method: 

B'000' PS Block chaining with seed and cipher text feedback* using the 

Data Encryption Standard (DES) algorithm (only value defined). 

28-k PS Session cryptography key enciphered under BIND receiver (or 

SLU) master cryptography key; an eight-byte value that, when 
deciphered, yields the session cryptography key used for enci- 
phering and deciphering FM data requests. 

Names and End User Data 

k+1 Length of BIND sender's name in field k+2-m. 

X'00' Field k+2-m does not exist. 

X'nn' Field k+2-m contains the number of bytes specified (cannot 
exceed X'08»). 

k+2-m BIND sender's LU name. 

m+1 Length of user data in field m+2-n. 

X'00' Field m+2-n does not exist. 

X'nn' Field m+2-n contains the number of bytes specified. 

m+2-n PS User data 

m+2 PS User data key. 

X'00' PS Structured subfields follow. 

-X'00' PS First byte of unstructured user data. 

Note: The unstructured user data continues in m+3 and goes to 
byte n. (For information on structured subfields, see the BIND 
information in SNA Format and Protocol Reference Manual: Archi- 
tecture Logi c. ) 

n+1 Length of user request correlation field. 

X'00' Field n+2-p does not exist. 

X'nn' Field n+2-p contains the number of bytes specified. 

n+2-p User request correlation field. 

p+1 Length of BIND receiver's name in field p+2-r. 

X'00' Field p+2-r does not exist. 

X'nn' Field p+2-r contains the number of bytes specified (cannot 
exceed X'08' ). 

p+2-r BIND receiver's LU name. 
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Notes 



The receiver of a nonnegotiable BIND request cannot return a negative 
response because a mandatory value is specified, but may return a negative 
response when an optional value is specified and the BIND receiver doesn't 
support it. 

The receiver of a negotiable BIND request may negotiate only the changing of 
an optional value to a mandatory value. It may unbind the session when an 
optional value is specified and the BIND receiver does not support it. 

When preparing a negotiable BIND response, the BIND receiver should indicate 
the PS profile options it actually supports (in bytes 20-23) and the options 
that the BIND sender should support (in bytes 16-19). 
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PART 2 CHAPTER 1. SNA CHARACTER STRING (SCS) CONTROLS 



This chapter defines the controls of the SNA character string used by LU-LU 
sessi ons. 



SNA CHARACTER STRING CONTROLS 



SNA character string (SCS) controls are EBCDIC control codes that may be used 
to define a data stream. Their primary function is to format a visual presen- 
tation medium, such as a printed page or a display screen. They also set 
modes of device operation, define data to be used in a unique fashion, or are 
used for communication between a device operator and an application program 
(where the specific function associated with the code is defined in a proto- 
col established between a program and an operator). 

Data streams based on SCS controls consists of a sequential string of SCS 
controls and data characters. These data streams are defined by the LU-LU 
session types that use SCS controls. This chapter defines the SCS controls 
that may be used to build these data streams, but no sets of controls are 
i denti f i ed. 

Controls may be intermixed with graphic data characters. SCS control codes 
are in the range X'OO' through X'3F' plus X'FF*. Graphic codes are in the 
range X'4Q' through X f FE'. Other data types (such as binary and packed deci- 
mal) are permitted, but only in conjunction with the Transparent (TRN), Pres- 
entation Position (PP), Program Operator Communication (POO, and Control 
Sequence Prefix (CSP) controls, discussed later. One-byte parameters that 
specify functions or binary values are permitted with some codes. 

SCS control codes and data appear within the RU portion of the basic informa- 
tion unit (BIU). They may be preceded or separated by other control informa- 
tion in the RU, such as function management headers (FMHs) and string control 
bytes (SCBs) for functions such as destination selection, data management, 
and compression or compaction. 

SCS functions do not include data flow control functions, even though both 
may be available to a keyboard operator through keys on the keyboard. 
CANCEL, for example, is a data flow control request which may be initiated by 
a key on the keyboard. 

SCS functions include certain unique graphic characters that contain control 
functions. (See "Graphic Codes that Possess Control Characteristics," 
"Adjust Text Mode," and "Text Justify Mode" later in this chapter.) 

An SCS control and parameter sequence may span RUs; an SCS control code 
and parameter sequence may not span RU chains. A receiver of these sequences 
must terminate any SCS parameter updating in process upon receiving a 
f i rst-i n-chai n or only-i n-chai n RU. Expected parameters that are not 
received are to be interpreted as invalid parameters within the chain 
containing the start of the SCS control code. 

Parameters in SCS controls are of two types: function and value. Function 
parameters are used to extend the function defined by the SCS control. For 
example, the PP control has a function parameter to define explicitly the 
positioning function to be performed. Value parameters are used to specify a 
numeric value associated with the SCS control. The PP control also has a 
value parameter associated with it. If the move is relative to the current 
position, the value parameter specifies the number of columns or lines the 
presentation position is to be moved from its current position. If the move 
is absolute, the value parameter specifies the absolute column or line number 
to which the presentation position is to move. 

Function parameters are EBCDIC characters; value parameters are binary 
numbers or graphic symbols. 
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SCS control functions are assigned EBCDIC codes as shown below. The control 

function ID is a one-byte or multiple-byte field (for example* OD for 

carriage return and 2BC6 for set line density). 

Code 

(EBCDIC) SCS Control Function Abbreviation 

16 Backspace BS 

2F Bell (Stop) BEL (STP) 

OD Carriage Return CR 

IB Customer Use 1 CU1 

3B Customer Use 3 CU3 

11 Device Control 1 DC1 

12 Device Control 2 DC2 

13 Device Control 3 DC3 
3C Device Control 4 DC4 

14 Enable Presentation ENP 

36 Expanded Backspace (Numeric Backspace) EBS (NBS) 

El Expanded Space (Numeric Space) ESP (NSP) X 

OC Form Feed (Page End) FF (PE) 

08... Graphic Escape GE 

05 Horizontal Tab HT 
39 Indent Tab IT 
33 Index Return IR 

24 Inhibit Presentation INP 
1C Interchange File Separator IFS 
ID Interchange Group Separator IGS 
IE Interchange Record Separator IRS 
IF Interchange Unit Separator IUS 

25 Line Feed (Index) LF (INX) 

15 New Line (Carrier Return) NL (CRE) 
00 Null NUL 
34... Presentation Position PP 
17... Program Operator Communication POC 

0A Repeat RPT 

3A Required Form Feed (Required Page End) RFF CRPE) 

06 Required New Line (Required Carrier Return) RNL (RCR) 
41 Required Space RSP * 
0450 Secure String ID Reader SSR 

04C1 Select Left Platen SLP 

046n Select Magnetic Encoder SME 

04C2 Select Right Platen SRP 

28. .. Set Attribute SA 

2BD1 Cn Set Chain Image SCI 

2BC8 Set Graphic Error Action SGEA 

2BC1 Set Horizontal Format SHF 

2BC6 Set Line Density SLD 

2BD2 29 Set Print Density SPD 

2BD1 Cn Set Translation Table STT 

2BC2 Set Vertical Format SVF 

OF Shift In SI 

0E Shift Out SO 

2BC3 Start of Format SOF 

38 Subscript SBS 

3F Substitute SUB 

09 Superscript SPS 

2A Switch SW 

CA Syllable Hyphen SHY X 

35... Transparent TRN 

1A Unit Backspace UBS 

04... Vertical Channel Select VCS 

0B Vertical Tab VT 

23 Word Underscore WUS 

Note; Functions with ellipses extending their 1-byte code (those that have 

the expression "..." following them) have one or more parameters and are 
multiple-character code points. 

* This function uses a graphic code. (See "Graphic Codes that Possess 
Control Characteristics" on page 150.) 
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CONTROL FUNCTION DESCRIPTIONS 



This section describes, in alphabetical order, the SCS controls that may be 
used to transmit a data stream between points in a network. 

The formatting controls are based on a presentation surface, which is mapped 
onto a device. The presentation surface consists of a matrix of character 
positions with an origin of column 1 and line 1. The maximum presentation 
surface width and depth may be the fixed parameters of the device? the top 
margin, bottom margin, left margin, and right margin are variable parameters 
(Figure 1-1). The variable parameters have default values specified later. 



Presentati on 

surface 

wi dth 



Presentati on 

surface 

depth 



TM = Top margin 



LM = RM= 

Left Right 

margin margin 



BM = Bottom margin 

i . J 



i j 

Column = C* | 
> I 



Line = L# 



MPL = Maximum 

presentati on 
li ne 



MPP = Maximum 

presentati on 
posi ti on 

Figure 1-1. The presentation surface. TM, BM, and MPL are expressed by a 
number whose origin is line number one (the topmost line of the presentation 
surface). LM, RM, and MPP are expressed by a number whose origin is column 
number one (the leftmost column of the presentation surface). 

The presentation position is defined by a pair of coordinates (L#,C#) that 
specify the line number and column number where the next graphic character 
will be displayed. The presentation position is the print head position on a 
serial printer, the next print position on a line printer, and so on. All 
characters are of a uniform size and all lines are uniformly spaced. 

A console consists of a presentation surface and a keyboard that are tied 
together by sharing a common buffer. When the keyboard enters characters 
into the buffer, they are also printed or displayed. Exceptions to this rule 
exist as noted under those SCS controls that are affected. 

The presentation surface is mapped onto a printer by making each page equal 
to a presentation surface, where the maximum presentation line (MPL), or page 
depth, is set to accommodate the printer form size. 

The physical positioning by the device is the same, whether the source of the 
control function is the received data stream or key action. When the source 
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is the keyboard* the control code is also inserted in the data stream being 
generated. 

The control definitions are presented in two stages. The first stage 
consists of the essential features within each control function; these are 
given below. The second stage augments the individual control definitions 
with generally applicable definitions for automatic line, column, and presen- 
tation surface advancement. 



BACKSPACE (BS, X'16') 



BS is a formatting control that moves the presentation position horizontally 
one position to the left. If the presentation position is at column one, the 
function becomes a no-op. Left margin settings are ignored. 

Using the (Li,C#) pair previously defined: 

CSCnewX maximum(l,CJKold)-l) 

LtCnewX L#(old) 

This function is for overstrike purposes and not for error correction. Back- 
space for error correction is a local device function, and requires a sepa- 
rate key that does not generate a code for transmission from the device. 

Differences can occur in the output if the presentation position is at the 
column one position when the backspace code is received. (See "Unexpected 
Output with Contiguous Backspaces" on page 154.) 



BELL (BEL, X'2F' 3 



del is a program-to-operator communication control usea in tne same Tasnion 
as POC. The difference is that BEL has no parameter associated with the 
control. For program-to-operator communication, BEL may perform a stop func- 
tion. This requires the device to stop processing the data stream until the 
operator action associated with BEL is performed. 



CARRIAGE RETURN (CR, X'OD') 



CR is a formatting control that moves the presentation position horizontally 
to the left margin on the same line. If the current position already equals 
the left margin, the function becomes a no-op. 

LSCnewX LS(old) 

CfKnewX LM 



CUSTOMER USE (CU) 



CUSTOMER USE 1 (CU1, X'lB') 
CUSTOMER USE 3 (CU3, X'3B») 

CU1 and CU3 are program-to-operator communication controls used in the same 
fashion as POC. The difference is that there are no parameters associated 
with the CU1 and CU3 controls. 
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DEVICE CONTROL (DC) 

DEVICE CONTROL 1 (DC1, X'll f ) 

DEVICE CONTROL 2 (DC2, X'12 f ) 

DEVICE CONTROL 3 (DC3, X'13') 

DEVICE CONTROL 4 (DC4, X»3C) 

DC1, DC2, DC3> and DC4 are device controls for device-specific control func- 
tions. For example* when data is directed to a magnetic stripe writer> DC1 
identifies a test record to be written on the magnetic stripe. 

ENABLE PRESENTATION (ENP, X'14<) 

ENP is a device mode control that enables the presentation of device-entered 
data at the enteri ng devi ce. All data entered at the device after receipt of 
the ENP control function is presented in the normal fashion. The ENP control 
function is used in conjunction with the INP control function to control 
presentation during the entry of sensitive data. 

EXPANDED BACKSPACE (EBS, X f 36') 

EBS is a formatting control that provides a large, fixed-size backspace used 
primarily for tabular and columnar formatting on proportional-space devices. 
The normal backspace on proportional-space devices does not provide this 
function because it is a variable-si zed backspace based on the previous chai — 
acter. On nonproporti onal devices, EBS may be folded into BS. 

EXPANDED SPACE 

See "Graphic Codes that Possess Control Character i sties" on page 150. 

FORM FEED (FF, X'OC) 

FF i s a formatting control that moves the presentation position to the top 
and left margins of the next presentation surface. If the MPL parameter has 
not been set (and no device-specific default exists), then it defaults to 
one; positioning is to the left margin of the next line. 

LKnewX TMCnext presentation surface) 

CKnewX LMCnext presentation surface) 

GRAPHIC ESCAPE (GE, X'08...') 

GE is a control that indicates that the bit-pattern (graphic) that follows 
shall be interpreted according to the most recently designated graphic escape 
page. GE appears as: 
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GEOGRAPHIC 



08 


BITS 



8 n 
where: 
BITS Is a bit pattern constructed within one or more bytes 



HORIZONTAL TAB (HT, X'OS') 



HT is a formatting control that moves the presentation position horizontally 
to the right to the next tab stop setting. Horizontal tab stop values may be 
set using SHF (set horizontal format). If no horizontal tab stops are set to 
the right of the current presentation position, HT results in a space. 

LiCnewX LJKold) 

If HTV(any)> C#(old) 

Then C*(new)< HTV(next) 

Else C#(new)< Ctt(old)+l 



where 



HTV = Horizontal tab stop value expressed as a column number. 
HTV(next) = Smallest HTV>C#(old) 



INDENT TAB (IT, X'39 f ) 



IT is a mode-setting control character that requires a device to generate one 
or more automatic horizontal tab operations after each new line is keyed or 
NL (new line) is seen on the outbound character string. IT has the effect of 
temporarily indenting the left margin. The number of automatic tabs 
performed is equal to the number of ITs inserted from the keyboard or seen in 
the outbound character string. The RNL (required new line) or IR (index 
return) control cancels the IT setting, or additional IT codes cause the tab 
setting to be moved farther to the right on the device. The number of ITs 
allowed is equal to the number of tab settings allowed. 

In indent tab mode, the device automatically tabs after each NL control that 
is present between IT codes and the RNL control. This tabbing is accom- 
plished without the presence of tab codes within the outbound character 
string. Indent tab mode does not preclude the use of embedded HT codes for 
additional tabbing if required. IT is treated as a no-op by half-sessions 
that do not support the adjust text function. 

Note; The text adjusting process automatically ends one line at approximate- 
ly the right margin and starts the next line at the left margin. When operat- 
ing in the middle of an indented paragraph, IT starts the new line at the 
proper tab location rather than at the left margin. 



INDEX RETURN (IR, X'33 1 ) 



IR i s a line-ending control character that is both a formatting control and a 
grouping control. 

As a formatting control, IR causes a mandatory movement of the print position 
to the left margin of the next line and resets indent tab mode. IR is similar 
to the RNL control, except that it may be used with magnetic media in such a 
way that the next line of display data may appear immediately following the 
IR code in the same magnetic card track. 

As a grouping control, IR is used to delimit the end of a field of a record 
and the end of a line on a magnetic disk medium. 
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INHIBIT PRESENTATION (INP, X T 24 f ) 

INP is a device mode control that inhibits the presentation of 

keyboard-entered data at the entering device, while allowing the entered data 
to be transmitted in the normal fashion. Presentation of all data entered at 
the device after receipt of INP is inhibited. Data received by the device is 
presented, not inhibited. In either case, the presentation position is moved 
in the normal fashion. INP is used in conjunction with ENP (described above) 
to control presentation during the entry of sensitive data. 

INTERCHANGE SEPARATORS (IUS, X'lF'; IRS, X'lE'j IGS, X'1D V ; IFS, X'lC) 

The interchange separators consist of IUS (interchange unit separator), IRS 
(interchange record separator), IGS (interchange group separator), and IFS 
(interchange file separator); they are used as logical separators. When used 
in hierarchical order, the ascending order is: IUS, IRS, IGS, IFS. That is, 
IUS codes separate the smallest units of data, while IFS codes separate the 
largest. 

An information block must not be split by a higher order separator; for exam- 
ple, a record may contain a whole number of units, but may not contain a part 
of a uni t . 

Within SCS, IRS has additional uses as follows: 

• Terminates a secure data string headed by an SSR control 

• Terminates a start-of-f ormat data string headed by an SOF control 

• Indicates the end of a card in a data stream sent to a card punch or 
received from a card reader 



LINE FEED (LF, X^S") 

LF is a formatting control that moves the presentation position vertically 
down to the next line. The column position remains unchanged. 

L#(new)<— L#(old)+l 
C#(new)< C#(old) 



NEW LINE (NL, X>15'} 

NL is a formatting control that moves the presentation position horizontally 
to the left margin, and vertically down to the next line. 

NL is functionally equivalent to CR followed by LF. 

LKnewX L#(old)+l 

C#(new)< LM 



NULL (NUL, X'OO') 



NUL is a control character that may be used as a time or media fill. On the 
presentation surface, NUL is treated as a no-op. 
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PRESENTATION POSITION IPP, X^*...') 

PP is a formatting control that moves the presentation position according to 
two parameter types: function and value. PP appears as: 

PP, FUNCTION-CODE, VALUE 



34 


CODE 


VALUE 



8 
where: 



16 



23 



The PP code (X f 34 f ) is followed first by the function parameter. The value 
parameter follows the function parameter; it is a 1-byte binary number and 
denotes either an absolute or relative column or line number. 

There sre four operations defined by the function parameter: 

Absolute move or relative move 

Horizontal move or vertical move 

Move and erase or move without erasing 

Erase to new position, then reset to old position 

Note: To erase a character at a position means to replace it with a device 
dependent character, generally a null or a space. 

Codes are assigned to allow combinations of these functions (see table, 
following). Erase functions ar^ intended for display devices. Value parame- 
ters for absolute moves can be equal to or less than the MPL or MPP, as appro- 
priate and, for relative moves, not past the end of the line or page. A zero 
value is a no-op. An error is indicated if any parameter is not valid. 

When an absolute move is specified, the value parameter denotes a specific 
line or column number, and the presentation position is moved to the line or 
column specified. For a printer, an absolute move to a line number less than 
the current line is equal to a move to that line on the following page. 

When a relative move is specified, the value parameter denotes a positive 
incremental value; the presentation position is moved the number of line or 
column increments specified. 

Function codes not shown in the following table are reserved. 

Function Parameter Code 



Absolute, 
Absolute, 



Hori zontal 
Hori zontal 



Absolute, Horizontal 



Absolute, 
Absolute, 



Verti cal 
Verti cal 



Absolute, Vertical 



Relati ve, 
Relati ve, 



Hori zontal 
Hori zontal 



Relative, Horizontal 



Relati ve, 
Relati ve, 



Verti cal 
Verti cal 



Relative, Vertical 



Move PP and do not erase X f CO f 

Erase line to new PP, then 

reset to old PP X'Cl f 

Erase line to and move to 

new PP X'C2» 

Move PP and do not erase X'C^ 1 

Erase column to new PP, 

then reset to old PP X'C5» 

Erase column to new PP 

and move to new PP X l C6 f 

Move PP and do not erase X'CS* 

Erase line through new PP, 

then reset to old PP X»C9» 

Erase line through, and move 

to, new PP X'4A» 

Move PP and do not erase X'^C* 

Erase column through new PP, 

then reset to old PP X*4D» 

Erase column through new PP 

and move to new PP X'4E f 



An absolute move with erase does not erase the new PP 
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PROGRAM OPERATOR COMMUNICATION (POC, X*17... v ) 

POC is a program-to-operator communication control that provides communi- 
cation between end users, where at least one of the end users is a terminal 
operator. The communication may be from a program to an operator, from an 
operator to a program, or from an operator to an operator. 

Typically, the program receives a POC sequence identifying one of several 
program function keys that an operator has activated; or the program sends a 
POC sequence that turns on one or more indicator lights visible to the opera- 
tor. The meaning associated with POC character sequences is defined by the 
end user. POC appears as: 

POC, FUNCTION-CODE, VALUE 



17 


CODE 


VALUE 



8 



16 



23 



Valid parameters are defined next; the handling of invalid parameters is 
discussed under "Invalid Parameter," on page 153. Values not defined are 
reserved. 



Function parameter 
Indicator lights Function key: 



No-op 

Set individual indicators on 

Set individual indicators off 

Set indicators by mask 

Set all indicators off 



No-op 

Identify function key 



Code 



X'CO 1 
X'C1» 
X»C2» 
X'CS' 
X'C4» 



Value Parameters; The value parameter is required on all POC sequences to 

provide a consistent length, but it has no meaning with the X'CO 1 and X'C4 I 

function parameters. When the function parameter is X'Cl* or X'C2 f , the 

valu 

key. 

f unc 

eter 

re>pr 

i ndi 

i ndi 

foil 



e parameter is a binary number defining a unique indicator or function 

Valid values are from 1 to 255, depending on the number of indicators or 
tion keys implemented. A zero value is a no-op. When the function param- 
is X'C3', the value parameter is treated as an 8-bit mask, where each bit 
esents an indicator. A zero value in the mask causes the corresponding 
cator to be set off, and a one value in the mask causes the corresponding 
cator to be set on. All bit-setting combinations of the value parameter 
owing the X'C3 f function parameter are valid. 



REPEAT (RPT, X'OA*) 



RPT is a device control used to manage a print buffer. It allows a device to 
print repeatedly the character string contained within a buffer. The repeat 
function is not performed at the time the code is placed in the buffer as the 
result of keyboard action. Instead, it is decoded during the process of 
printing the contents of a buffer. The function resets the buffer location 
pointer to the beginning of the character string to be repeated. (See 
"Auto-Letter Mode" on page 152 for the use of this function.) 



REQUIRED FORM FEED (RFF, X'3A ( ) 

RFF is a formatting control that stops printing of the page and forces a form 
feed to the top and left margins of the next page on those devices that have 
this capability. RFF contrasts with the Form Feed (FF) code, which may be 
replaced or eliminated on those machines that have the capability to adjust 
text. Machines that do not have or are not using this capability may treat 
the RFF code as an FF code, and not cause an error condition. 
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REQUIRED NEW LINE (RNL, X'06*) 



RNL is a formatting control that causes a mandatory move of the print posi- 
tion to the left margin on the next printing line. This character is distin- 
guished from the regular NL (new line) control in that NL is ignored when the 
machine is in an adjust-text mode. On those machines that do not have or are 
not using the adjust-text capability, RNL may be treated as NL, and no error 
condition created. 

RNL may also be used to terminate a start-of-format data string headed by an 
SOF control. (See "Start of Format" on page 146.) 



REQUIRED SPACE 



See "Graphic Codes that Possess Control Characteristics" on page 150 



SECURE STRING ID READER CSSR, X'0450 v ) 

SSR is used to distinguish between an operator identification number entered 
into the system from a magnetic stripe reader and one entered from a 
keyboard. This is accomplished by delimiting a magnetic stripe number with 
the SSR and IRS controls. (See "Interchange Separator" on page 135.) 

Because magnetic stripe readers may be used to read both credit cards and 
operator identification cards, a device attaching a magnetic stripe reader 
must distinguish between the two types of cards and apply the SSR control to 
the data from the magnetic stripe on the operator identification card only. 
These magnetic stripes are distinguished by the use of an operator identifi- 
cation code as the first data character on the stripe containing an operator 
identification number. Before the data read from the stripe is forwarded, 
the code is replaced by the SSR control and the end of data code from the 
stripe is replaced by the IRS control. Data designated as secure through use 
of the delimiting SSR and IRS codes is not printed or displayed, nor can it be 
edited in the buffer. SSR appears as: 

SEL, READER 



04 


50 



8 15 



SELECT LEFT PLATEN (SLP, X "04C1") 

SLP, or select primary platen, is a device control that causes the data 
following it to be printed on the platen, starting from the left margin of the 
printer. When SLP is in effect, all the formatting control such as left 
margin, right margin, top margin, bottom margin, MPP, vertical and horizontal 
tab stops, and so on, are associated with the left platen only. Once SLP is 
issued, it remains in effect until another selection is made. When neither 
SLP nor SRP (select right platen) are in effect, the left platen is selected 
by default. SLP appears as: 

SEL, LEFT-PLATEN 



04 


CI 



8 15 
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SELECT MAGNETIC ENCODER (SME, X'04...') 

SME is used to denote the start and encoding options of an EBCDIC data stream 
to be encoded on a magnetic stripe. The end of the data stream is denoted by 
the IRS control. Invalid graphic characters cause a negative response indi- 
cating an RU data error. This error response is also sent if the magnetic 
stripe message length is greater than the device capacity. SME appears as: 

SEL, FUNCTION-CODE 



04 


CODE 



8 



15 



The character following X'04 f is used to define the magnetic stripe code set 
to be used in the operation and whether the data stream is secure or 
nonsecure. 



Functi on 



Code 



Encode non-secure data, numeric set 
Encode secure data, numeric set 
Encode non-secure data, alphanumeric set 
Encode secure data, alphanumeric set 



60 
61 
62 
63 



If multiple SME data streams are received by the encoding device, only the 
last one received is retained for encoding. 



SELECT RIGHT PLATEN (SRP, X , 04C2 , 3 

SRP, or select secondary platen, is a device control that causes the data 
following it to be printed on the right platen, starting from the left margin 
defined for right platen. When SRP is in effect, all the formatting 
controls, such as left margin, right margin, top margin, bottom margin, MPP, 
vertical and horizontal tab stops, and so on, are associated with right plat- 
en only. Once SRP is issued, it remains in effect until another selection is 
made. When neither SRP nor SLP are in effect, the left platen is selected by 
default. SRP appears as: 

SEL, RIGHT-PLATEN 



04 


C2 



8 15 



SET ATTRIBUTE (SA, X f 28... f ) 



SA i s a control that associates attribute values to the graphic characters 
that follow in the data stream to define: 

Hi ghli ghti ng 
Color 
Character set 



SA appears as: 
SA, TYPE, VALUE 



28 


TYPE 


VALUE 



16 



23 
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where: 

Type = Characteristic to be defined 
X'41' - Highlighting 
X'42' - Color 
X'43' - Character set 
X'OO 1 - Reset characteristics 

Value = Attribute value to be associated to the following SCS graphic charac- 
ters according to the type code. 

Values are shown below by type: 

Hi ghli ghti ng 

X'OO 1 - Default 

Other - All other values &r& assigned to highlighting identification 
by the Query Reply (Highlight) structured field. 

The value X'OO' selects the device default highlighting indicated in the 
Query Reply (Highlight) structured field. 



Color 



X'OO' - Default 
X»F7» - Multicolor 

Other - All other values are assigned to color identification by the 
Query Reply (Color) structured field. 

Values X f 00 f and X* F7 f have unique data stream meaning. The value X'OO* 
selects the device default color indicated in the Query Reply (Color) 
structured field. The value X'F7' indicates the color is defined using 
a triple-plane programmed symbol set. If a single-plane character set 
is referenced, the color defaults to the single color specified for the 
X'F7' data stream value by the Query Reply (Color) structured field. 

Character Set 

X'OO* - Default - base character set 
Other - Defined by user 
X'FF* - Reserved 

The default values are: 

Highlighting - No highlighting, normal presentation of graphics as 
defined by the implementor. 

Color - Monochrome color as defined by the implementor 

Character set - Base character set as defined by the implementor 

SA values &re associated with their respective type upon setting and until 
receipt of another SA control of the same type. Therefore the set of attri- 
bute values is a composite by attribute type of the attribute specified in 
any previously encountered SA control. For example: 

Sett i ng 

Initial Setting 

SA color red 

SA character set X'FS 1 

SA color blue 

SA highlight underline 

Unrecognized attribute values are handled in the following ways: 

Highlighting and Color: Unsupported valid values are folded into implementa- 
tion defined supported values for presentation. 

Whenever a hyphen is substituted for an undefined graphic or for an unsup- 
ported/invalid control code, the color and highlighting data stream attri- 
butes associated with the substituted code point still apply. 
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Highlight 


Color 


Character 


set 


Default 


Default 


Default 




Default 


Red 


Default 




Default 


Red 


X'F3» 




Default 


Blue 


X'F3» 




Underli ne 


Blue 


X'F3» 





Invalid values are rejected with a negative response. 

Character Set: Unsupported values are rejected with a negative response. 

SET CHAIN IMAGE (SCI, X^B... 1 ) 

SCI specifies a character set image. It is used to load a character set image 
into a chain printer. SCI appears as: 

CSP, CLASS, COUNT, CHAIN, IMAGE 



2B 


Dl 


CNT 


CX 


IMAGE 



16 



24 



32 



where: 
2B Dl 



CNT 



CX 



IMAGE 



Specifies a multi ple-character-set-and-font class of control func- 
ti ons. 

One-byte count field indicating the length of the sequence including 
the CNT byte. A count byte of or 1 is invalid. If the count byte 
is 2, the default of the device i s to be used. 

SCI control function and chaining indicator: 

X'C6* - First segment of the chain image 

X'C4' - Middle segment of the chain image 

X'C5 f - Last segment of the chain image 

X'C7' - Only segment of the chain image 

The chain image 



Chained SCI controls must follow in sequence, and no intervening SCS controls 
should appear between them. The first character after the chaining byte in 
the first or only segment in the chain represents the first character past 
home on the chain. If the length of the SCI image and the hardware on the 
device are not equal, the chain image is truncated or repeated as required. 



SET GRAPHIC ERROR ACTION (SGEA, X f 2B... f ) 

SGEA specifies the action to be taken when an unsupported or unprintable 
graphic character is received, either online or from a spooling file. SGEA 
specifies if a sense code is to be issued, or if printing is to continue, with 
a substitute graphic to represent the unprintable graphic. 

The SGEA control contains a 1-byte count field (always X*03 f ), the substitute 
graphic, and a 1-byte binary field to indicate whether to continue or to send 
a negative response. SGEA appears as: 



CSP, CLASS, COUNT, GRAPHIC, ACTION 



2B 


C8 


03 


GR 


AC 



16 



24 



32 47 



where ACTION is defined as: 

X'01' Print substitute graphic and continue 
X'03* Issue a negative response 

The default action taken when an unsupported graphic is found is discussed 
under "Unsupported Graphics" on page 153. If SGEA is issued, it overrides 
that act i on . 
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SET HORIZONTAL FORMAT (SHF, X^B... 1 ) 



SHF sets horizontal formatting controls* including maximum presentation 
position, left and right margins, and horizontal tab stops. A 1-byte binary 
count follows the SHF control; it indicates the number of bytes to the end of 
the SHF sequence, including the count byte. The first three parameters 
following the count define the maximum presentation position, the left 
margin, and the right margin, respectively. Tab stop parameters follow the 
right-margin (RM) parameter position. Parameters of SHF are 1 byte each, and 
contain binary numbers in the range 0-255. 

The receipt of the SHF control sets all horizontal formatting controls to 
their default values. The minimum valid sequence which may be sent is SHF 
with a count of one, in which case all horizontal formatting controls have 
default values. A zero value for any other SHF parameter is a no-op and 
results in the function retaining its default value. The default values to 
be assumed are those described below under the definition of each parameter, 
unless default values are established by local action at the device, in which 
case the locally established values are assumed. SHF appears as: 

CSP, CLASS, COUNT, MPP, LM,RM,T1, . . .Tn 



2B 


CI 


CNT 


MPP 


LM 


RM 


Tl 




Tn 



16 



24 



32 



40 



48 



56 



where: 
MPP 



Maximum presentation position: Specifies the horizontal extent of 
the presentation surface (for example, print-line length, in number 
of characters, with column one the origin). Valid MPP values are 
less than or equal to the device physical maximum presentation posi- 
tion. The MPP default value is the physical device line length. 



LM 



Left margin value: 



Specifies the column value of the leftmost pres- 



Valid LM values are values less than or equal to MPP. 
value i s one. 



The LM default 



RM Right margin: Used to assist an operator in formatting 

keyboard-generated data streams. One of its functions i s to warn the 
operator that the end of the line is approaching; the warning is 
issued only once, when the presentation position column number equals 
RM minus 10. If the distance between LM and RM is ten or less, the 
warning is not issued. Valid RM values are values greater than or 
equal to LM and less than or equal to MPP. The default value for RM 
i s MPP. 

Tl..Tn Horizontal tab stop parameters: Set column values for use with the 
Horizontal Tab (HT) function. The tab string does not have to be in 
order. Valid tab stop values other than zero are values equal to or 
greater than LM and less than or equal to RM. 

Note: The LM parameter is the first horizontal tab stop; repeating 
the LM value in the horizontal tab stop parameter sequence is redun- 
dant. When no tab stop values sre set to the right of the current 
presentation position column value, the HT function acts as a space 
functi on. 

The following algorithm is executed by a half-session when SHF is received: 

1. The SHF parameters are scanned, checked for validity, and saved in sn SCS 
control vector. 

2. An appropriate negative response is sent if an error is detected; the 
effect of the saved parameters is undefined. (For predictable results, 
any recovery sequence must include a valid SHF.) 

To avoid unpredictable results, an SHF must be followed by an FF, RFF, NL, or 
RNL control. Although an FF, RFF, NL, or RNL control does not have to imme- 
diately follow the SHF, there must be no intervening data or control code 
that causes movement of the active presentation position. Where one of these 
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controls does follow a sequence of formatting controls (for example, SHF, 
SPD), the ordering of the sequence has no effect on the execution of the 
following controls. LM positioning is in terms of the new SHF parameters. 

Since default values for MPP, LM, RM, and horizontal tabs may be established 
by local action at a device, it is necessary, when using these parameters to 
format the presentation surface, to send SHF or to rely on end-user defined 
procedures to establish the values. 



SET LINE DENSITY (SLD, X'2B...') 

SLD specifies the distance to be moved for a single-line vertical space as in 
LF or NL. It contains a 1-byte count field and a 1-byte binary parameter. 
The binary parameter expresses the vertical distance in standard typographic 
points (one point = 1/72 inch). Thus, a value of 12 points would indicate six 
lines to the inch; 9 points would indicate eight lines to the inch; and 72 
points would indicate one line to the inch. 

When the SLD control is received, the device sets line density to its default 
value before analyzing the count and density fields. This default value is 
retained unless valid count and density values are received. The following 
parameter values are accepted without rejection with default values retained: 



Count 
Count 



byte = X'02 f 
byte = X*01 f 



and points 
( i ndi cates 



byte = X'OO' 
no points byte) 



Count values other than X'01* and X*02* and points values other than X'OO* 
and those implemented by the device must be rejected with an error response 
indicating an invalid parameter. SLD appears as: 

CSP, CLASS, COUNT, POINTS 



2B 


C6 


CNT 


PNTS 



8 



16 



24 



31 



The implementing device must specify the points values it implements and the 
default value. The device default value may be established by local action. 
If so, the locally established values are assumed as defaults in the cases 
mentioned above. To avoid unpredictable results, such as loss of forms 
integrity, an SLD must be followed by an FF or RFF control. Although the FF 
or RFF control does not have to immediately follow the SLD, there must be no 
intervening data or control code that causes movement of the active presenta- 
tion position. When one of these codes is used following a sequence of 
formatting controls (for example, SLD, SHF), the ordering of the sequence has 
no effect on the execution of the formatting controls. 

The FF or RFF control causes exiting of the current presentation surface in 
terms of the old SLD parameter, but positioning in the next presentation 
surface is done in terms of the new SLD parameter. 

The line density specified by SLD becomes effective immediately on receipt of 
SLD. 

Note: Failure to observe the following rules results in misalignment of the 
printed output relative to the form: 

• When the using application always specifies TM = 1, the form must be posi- 
tioned to line 1 (for example, by using FF) prior to the receipt of SLD. 

• When a TM greater than 1 is being used, the form must be manually aligned to 
the applicable TM prior to receipt of SLD (the alignment must be in terms of 
the line density specified in the SLD). 

• A change of line density requires a corresponding change of MPL or physical 
forms, or both. 
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SET PRINT DENSITY (SPD, X V 2B...") 

SPD is a formatting control; it specifies the number of characters to be 
presented per inch in the horizontal direction. SPD appears as: 

CSP, CLASS, COUNT, TYPE, CHARACTER-DENSITY 



2B 


D2 


CNT 


29 


CD 



8 16 



24 



32 47 



where: 

CD is character density: A 2-byte binary number from 1 to 255, specifying the 
number of characters to be printed per inch. Numbers 256 to 65535 are 
reserved. If CNT = X»04» and CD = X'0000' or CNT = X'02', the default value 
of the device is used. 

The character density specified in SPD becomes effective immediately on 
receipt of SPD. When the SPD code is received, the device sets the character 
density to its default value. The default value is retained unless valid 
count and character density values are received. 

Note: If a change in character density is not compensated by changes in LM, 
RM, and MPP using SHF (set horizontal format), the left and right margins may 
be mi sali gned. 



SET TRANSLATION TABLE (STT, X'SB...*) 

STT is a device control used to load the character set translation table in a 
chain printer. STT appears as: 



2B 


Dl 


CNT 


CX 


RESERVED 


START 


IMAGE 





where 
2B Dl 
CNT 

CX 



8 16 



24 



32 



64 



80 



START 
IMAGE 



Indicates multi ple-charactei — set-and-font class of control. 

Is a 1-byte count field indicating the length of the sequence includ- 
ing the count byte. 

The STT control function and the segment of the translation table as 
follows: 

X'C2 1 ' First segment of the translation table 

X'CO* A middle segment of the translation table 

X'Cl" Last segment of the translation table 

X f C3 f Only segment of the translation table 

Is a 2-byte field indicating at what starting position in the trans- 
lation table the new image is loaded. The default is X'FFFF'. 

The variable-byte translation table. 



SET VERTICAL FORMAT (SVF, X^B...') 

SVF sets vertical formatti ng controls, including maximum presentation line 
(page size), top margin, bottom margin, and vertical tab stops. A one-byte 
binary count follows the SVF code; it indicates the number of bytes to the end 
of the SVF string, including the count byte. 
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The receipt of the SVF code sets all vertical formatting controls to their 
default values. The minimum sequence that can be sent is with a count of one, 
in which case all vertical format controls are set to their default values. 

A zero value for MPL, TM, or BM is a no-op and results in the function retain- 
ing its default value. The default values to be assumed are those described 
below under the definition of each parameter, unless default values are 
established by local action at the device, in which case the locally estab- 
lished values are assumed. Vertical tab stop parameters in the SVF sequence 
start after the bottom-margin (BM) parameter position. Parameters of SVF are 
one byte each, and contain binary numbers in the range 0-255. SVF appears as: 



CSP, CLASS, COUNT, MPL ,TM,BM,T1, . . .Tn 



2B 


C2 


CNT 


MPL 


TM 


BM 


Tl 




Tn 



16 



24 



32 



40 



48 



56 



where: 

MPL Maximum presentation line: Defines the vertical extent of the pres- 
entation surface with origin of line one. This is the page depth 
for a printer or the number of lines in a display. All values from 1 
to 255 are valid. A page size defined by SVF takes precedence over a 
fixed device value such as display screen line capacity. The 
default value is the device-fixed line capacity, for those devices 
that have a fixed-line capacity, and the locally-established MPL for 
those devices capable of establishing values locally, and is one for 
devices with neither fixed-line capacity nor locally-setable 
values. 

TM Top margin: Specifies the line value to be used as the top presen- 
tation line of the page. The TM is also the first vertical tab stop. 
Valid TM values are equal to or less than MPL. The default value for 
TM i s one. 

BM Bottom margin: Specifies the line value that, if exceeded by 

L#(new), causes an automatic skip to TM of the next presentation 
surface. BM must be greater than or equal to TM, and less than or 
equal to MPL. The BM default value is the MPL value. 

Tl...Tn Vertical tab stops, selected by VT, or vertical channels, selected 
by VCS. 

Each vertical tab stop parameter specifies a single-line value for 
use with the vertical tab (VT) function. Valid vertical tab values 
are equal to or greater than TM (the first vertical tab stop which 
must not be specified explicitly) and equal to or less than BM or 
X'00'. While X'00* is a permissible tab stop value, only nonzero 
values are processed. MPL must be specified as a value greater than 
one if useful vertical tab stops are to be available. Vertical tabs 
must be listed in increasing order if predictable results are to be 
achieved with the VT function. Vertical tab stops may be set at any 
line, except TM, down to, and including, bottom margin. 

Tab stop parameters 1 through 11 are also used to set line values 
for corresponding control channels 2 through 12; channel 1 is set by 
the TM. This allows vertical formatting to be accomplished with the 
vertical channel select (1-12) function in addition to the VT func- 
tion. The value zero may appear in any of tab stops 1 through 11. A 
zero line value specified to correspond to any of channels 2 through 
12 will result in a default to the LF function when a select channel 
is given for that channel number. A select channel 1 causes line 
positioning to move to the TM of the next presentation surface with 
no change in column position. Vertical tab line values must be in 
increasing order when used to set channel stops, except that the 
value zero may appear out of sequence. 

The following algorithm is executed by a half-session when SVF is received: 

1. The SVF parameters are scanned and checked for validity and saved. 
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2. An appropriate negative response is sent if an error is detected. The 
effect of the saved parameters is undefined. CFor predictable results/ 
any recovery sequence must include a valid SVF.) 

The SVF parameters become effective immediately on receipt of SVF; the device 
assumes the form is aligned to the line specified by the TM parameter. 

Note: Unless the using application always specifies a TM = 1, the form must 
be manually aligned to the line specified by TM prior to the receipt of SVF. 
Failure to observe the preceding rule results in misalignment of the printed 
output relative to the form. 

Since default values for MPL, TM, BM, and vertical tabs may be established by 
local action at a device, it is necessary, when using these parameters to 
format the presentation surface, to send SVF or to rely on end-user defined 
procedures to establish the values. 



SHIFT IN (SI, X'OF') 



SI is a mode control that indicates the bit patterns which follow shall be 
interpreted according to the most recently designated Shift In graphic code 
page. 



SHIFT OUT (SO, X'OE') 



SO i s a mode control that indicates the bit patterns which follow shall be 
interpreted according to the most recently designated Shift Out graphic code 
page. 



START OF FORMAT (SOF, X V 2B...*) 

SOF is a grouping control that is used as a delimiter to separate normal data 
from unique header information. SOF appears as: 

CSP,SOF-CODE 



2B 


C3 



8 15 

The SOF control functions are: 

Single index 

Double i ndex 

Adjust mode on 

Adjust mode off 

Tab 

Right margin setting 

The format of this information must be such that a simple machine can print 
out these parameters so that an operator can use this information to manually 
set up the machine, or a more intelligent machine can operate on this same 
parameter format to automatically set up itself. This special mode in the 
character string is terminated by the RNL (required new line) or IRS (intei — 
change record separator) control. An error condition can be generated when a 
device does not see an SOF-RNL or SOF-IRS pair in the proper sequence in the 
outbound character string. 



146 SNA — Sessions between Logical Units 



SUBSCRIPT (SBS, X'38') 



SBS is a formatting control that causes a fractional line feed operation in 
the forward direction. The value of the fraction is less than one line and is 
equal to the equivalent superscript movement. This is a latching type 
control, which requires an SPS (superscript) control from the sending 
half-session to return the presentation position toward the base line. 

Multiple SBS characters may be used when multiple levels of subscript are 
required, and each must be canceled with a corresponding SPS code to return 
the presentation position to the base line. 

A subscript is logically a part of the base-line word or character and, thus, 
is not split between lines when automatic new line is performed. 

Any line advance before returning to the base line gives unpredictable 
results. 

See Figure 1-2 for a flowchart of SBS interpretation. 



SUBSTITUTE (SUB, X^F* ) 



SUB i s an error control that replaces a character that is determined to be 
invalid or in error. For example, during translation from EBCDIC to ASCII, 
the SUB control may be used in the ASCII code set to represent codes that have 
a definition in the EBCDIC code set but have no definition in the ASCII code 
set . 



SUPERSCRIPT (SPS, X , 09») 



SPS is a formatting control that causes a fractional line feed in the reverse 
direction. The value of the fraction is less than one line, and is equal to 
the equivalent subscript movement. This is a latching type control, which 
requires a subscript (SBS) code from the sending half-session to return the 
presentation position toward the base line. 

Multiple SPS codes may be used when multiple levels of superscript are 
required, and each must be canceled with a corresponding SBS code to return 
the presentation position to the base line. 

A superscript is logically a part of the base-line word or character and, 
thus, is not split between lines when automatic new line is performed. 

Any line advance before returning to the base line provides unpredictable 
results. 

See Figure 1-2 for a flowchart of SPS interpretation. 



SWITCH (SW, X'2A') 



SW is a device control used to manage print buffers. Its purpose is to 
provide a mechanism for switching dynamically between two print buffers 
during the printing process. Inherent with the switch function is the 
requirement that each buffer maintain a buffer location pointer. This point- 
er indicates the buffer location that supplies the next data or control char- 
acters. 

The switch function is not performed at the time the code is placed in the 
buffer as a result of keyboard action. (See "Auto-Letter Mode" on page 152 
for the use of this function.) 
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Mark start 
of word 



Present S 



Get next S 



Update 
temporary 



rresenx o 
(Note 2) 



Get nextS 




Get next i S 




Note It Any line-ending code within an SBS/SPS expression can cause unpre- 
dictable results. 

Note 2: Flowchart logic assumes that there is always a printable character 
following SBS or SPS. 

Figure 1-2, Example of subscript and superscript scan algorithm (S = next 
character in string) 
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SYLLABLE HYPHEN (SHY, X'CA') 



See "Graphic Codes that Possess Control Character! sti cs," on page 150 



TRANSPARENT (TRN, X^S...') 



TRN is a data-defining control used to denote the start of a transparent data 
stream. The data delimited by TRN is end-user defined and is not scanned for 
SCS control codes. TRN appears as: 

TRN, COUNT 



35 


CNT 



8 

where: 



15 



CNT Indicates the number of bytes of transparent data (not including the 
count byte) . 

After processing the TRN data, the presentation position must be moved CNT 
posi ti ons. 



UNIT BACKSPACE (UBS, X'lA 1 ) 



UBS provides the small (less than character width) incremental capability 
needed to get absolute vertical alignment of line endings on proportional 
space devices. 

Nonproporti onal-space machines may ignore this code. 



VERTICAL CHANNEL SELECT (VCS, X'O*...') 

VCS is a formatting control used to select one of twelve vertical channels 
for the purpose of controlling the vertical format of a presentation surface. 

Line stop values for each channel used must be designated before using these 
select functions if default values are not to be used. (See "Set Vertical 
Format," on page 144.) 

When the current line number is greater than or equal to the largest line 
value specified for the channel selected, positioning is to the next page, 
and the line value specified for the selected channel is used. When there are 
no line stop values specified for a channel, a select channel function for 
that channel defaults to LF (line feed). 

VCS appears as: 

SEL, CHANNEL-CODE 



04 


CODE 



16 



Part 2 Chapter 1. SCS Controls 149 



where: 

Select function Code 

Select channel one X'Sl* 

Select channel two X'&2' 

Select channel three X'83 f 

Select channel four X'84' 

Select channel five X'85" 

Select channel six X'86 f 

Select channel seven X'87' 

Select channel eight X'88 1 

Select channel nine X*89* 

Select channel ten X^A" 

Select channel eleven X'7B f 

Select channel twelve X'7C* 



VERTICAL TAB (VT, X'OB*) 



VT is a formatting control that moves the presentation position vertically 
down to the next tab stop setting. Vertical-tab stop values may be set using 
SVF (set vertical format). If there are no vertical tab stops set below the 
current line number, VT defaults to LF (line feed). While zero is a permissi- 
ble tab stop value, only nonzero values are processed. 

C*K new)< C#(old) 

IF: VTV(any) > L#(old) 

Then: L#(new)< VTV(next) 

Else: L#(new)< L#(old)+l 



where: 



VTv - Vertical tab stop vaxue expressed as a line number. 
VTV(next) = Smallest VTV>L#(old). 



WORD UNDERSCORE (WUS, X'23') 



WUS is a device control which, when entered from the keyboard or executed 
during printing, causes the entire word immediately preceding the WUS control 
to be underscored. The word to be underscored is defined as the string of 
characters before the WUS code back to one of the following: space, undei — 
score, or any of the SCS controls except SPS and SBS (superscript and 
subscri pt) . 



GRAPHIC CODES THAT POSSESS CONTROL CHARACTERISTICS 

This section lists graphic codes that have unique control characteristics in 
certain applications. 



EXPANDED SPACE (ESP, X'El') 



ESP is a large, fixed-size space used in justification of text and in colum- 
nar and forms applications for proportional-space devices. The normal space 
frequently is not large enough to provide the columnar formatting function. 
Text can be justified more easily when two different space widths are used. 
Nonproporti onal-space devices may recognize this control as a normal space. 
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REQUIRED SPACE CRSP, X v 41 v ) 



RSP is distinguished from the normal space in that it is treated as any graph- 
ic character and therefore is not considered an interword space on those 
machines that have adjust-text capability. Implementations that do not have 
this capability may default RSP to a normal space without causing an error. 



SYLLABLE HYPHEN (SHY, X'CA 1 ) 



SHY is a graphic that prints as a normal hyphen (X f 60'). Its use is limited 
to a syllable boundary at a line ending to indicate the continuation of a word 
on the next line. Use of a unique control for this function permits the 
syllable hyphen to be discarded in adjust-text mode when the adjusting proc- 
ess moves the word away from the line straddling position. The normal hyphen 
is treated as any other graphic in adjust-text mode and is never discarded. 
In devices without adjust-text capability, the syllable hyphen is treated as 
a normal hyphen. 



MEDIA FORMATTING 



The formatting controls described earlier format the output medium at a 
device. In addition to these controls, a device implementing the SNA charac- 
ter string (SCS) can format a received character string to fit the line 
length of the device automatically. This capability of automatic new-line 
generation eliminates device line-length dependencies from those applica- 
tions where a specific output format is not required. Thus, the same charac- 
ter string can be sent to devices with varying line lengths without having to 
reformat the character string. 



been exceeded. This implies a character look-ahead and allows execut 
control codes such as BS (backspace) before the automatic new line is 
performed. This function is mandatory for the output string only. When a 
character string is generated from the keyboard, the device implementations 
may optionally perform an automatic new line or reject additional keyboard 
input when MPP is exceeded. 

A device that provides left-adjusted text may discard space characters that 
would occur at the beginning of a line, and may adjust the text to avoid 
improper placement of punctuation marks at the beginning of a line. 

When specific line and page formats are required, formatting controls are 
used. The automatic new line feature is always active; thus, a character 
string formatted for a given line length can be presented on a device with a 
shorter line length without loss of data, but the format is changed. When 
reversed (where a character string is constructed for an MPP that is less 
than the line length capability of the device it is directed to), use of the 
smaller MPP in an explicit SHF allows the string to be presented without loss 
of data or change of format. 

BM (bottom margin) specifies a line value that, when exceeded by L#(new), 
causes an automatic skip to TM (top margin) of the next page. The function 
that causes the line positioning to exceed the BM value determines the hori- 
zontal positioning on the new line. For example, if NL (new line) causes the 
automatic skip, the horizontal positioning is to the left margin. If LF 
(line feed) causes the automatic skip, the horizontal positioning is 
unchanged. Note that automatic new line may also cause an automatic skip if 
the new line created exceeds BM. 

SCS formatting controls assume that the output medium consists of a matrix of 
columns and lines, where column one, line one, is the top left position on a 
page or display screen. FF (form feed) positions the print element to a 
predefined column (LM) and line (TM) on a new page or screen. 
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Valid column values for a device are from one to the device maximum. In addi- 
tion to column positioning by defined controls, each graphic data character 
causes the column position to be incremented by one after printing. 

Line positioning is accomplished through the use of control functions that 
can alter line values. Use of functions that specify a line position greater 
than the next sequential line requires the definition of a page size in terms 
of the total number of lines on the page. The page size may be defined as a 
fixed value for a given device (such as a display), or it may be specified via 
a parameter on SVF (set vertical format). The page size given with SVF takes 
precedence over a device-defined page size value. 



RELATIONSHIP OF INPUT AND OUTPUT 

Implementation of SCS by an input/output device may include the capability to 
generate, as well as receive, SCS controls. An input string can contain all 
the control functions defined for SCS. SCS controls that are initiated from 
a device keyboard cause the insertion of the appropriate SCS code in the data 
stream that is transmitted from the device. 



ADJUST-TEXT MODE 

Adjust-text mode allows implementations to reformat text to accommodate vary- 
ing line lengths and page sizes, and to provide assistance to the operator in 
adjusting line endings. When a device is in adjust-text mode, certain 
formatting controls may be eliminated in the adjusting process, and others 
may not be eliminated. Required controls are RSP (required space), RNL 
(required new line), and RFF (required form feed). SHY (syllable hyphen) and 
IT (indent tab) are also required. 

A device is placed in adjust-text mode by SCS data stream control or an opera- 
tor key on the keyboard. 



TEXT-JUSTIFY MODE 

Text-justify mode allows implementations to reformat text to align the line 
endings exactly on right margin. This is accomplished by changing the effec- 
tive width of the interword space throughout the printed line. SCS controls 
for proportional spacing, such as EPS (Expanded Space), EBS (Expanded Back- 
space), and UBS (Unit Backspace) are used separately or in combination to 
create the desired space width. The device is placed in text- justify mode by 
an SNA character string control or an operator key on the keyboard. 

AUTO-LETTER MODE 

Auto-letter mode allows implementations to create a set of finished documents 
(letters) from two different text sources. These sources can be any combina- 
tion of memory buffers, magnetic media, operator keyboards, or even the 
communication line. By using the SW (switch) and RPT (repeat) controls, the 
two sources of text can be serially combined in any desi red fashion to 
produce completed documents. The normal use of this mode is to prepare 
completed letters from one source containing the body of the letter and a 
second source containing names and addresses. 



FORMAT CONTROL PARAMETER DEFAULT 

Active format control parameters are to be determined in the following prior- 
ity: 
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1. Received via the data stream as a valid parameter (that is, within limits 
defined for the specific parameter) following a valid format control 
code. 

2. Locally defined. A locally defined parameter may be of types: 

a. Hardware physical limits, for example, the MPP limit of 132 on a 
printer. 

b. Retainable (static) operator-established values for example, MPL set 
in rotary or decade switches. 

An example of nonretai nable operator established values that would not be 
available for a default return would be dynamic horizontal tab values 
entered by an operator from a keyboard. If these values were dynamically 
entered into an active table, they may be over written by a valid SCS 
parameter and not available for default later. 

3. Architecture defined. An architectural default is defined for each 
parameter. If a parameter for type 1 or 2 above is not available, this 
value is made active. 

Note: For predi ctable results, any recovery must include a valid format 
control code and parameters. 



ERROR HANDLING 



SCS errors are considered errors encountered in creating the character 
string. They are either program errors or operator errors, depending on the 
source of the character string. 



INVALID CONTROL CODE 



This error occurs when a control code or control code sequence is detected by 
a receiving device that has not implemented the received code. 



INVALID PARAMETER 



This error is indicated when a function or value parameter is detected that: 

• Contains an invalid code for that parameter 

• Contains a value that is outside the range of the device. This includes the 
case of vertical positioning past the next sequential line, when there has 
been no presentation surface size specified for the device. In the absence 
of a defined presentation surface size, either inherent in the device or 
specified by SVF (set vertical format), a device is considered to have a 
presentation surface size of one line. 

Note: For sessions where it is important to display as much of the data as 
possible, even if an occasional error occurs, or for spooled, offline, print- 
ing jobs where an error response would be meaningless, a default action may 
be substituted for an invalid control code or an invalid parameter. 



UNSUPPORTED GRAPHICS 



If characters from a large character set are transmitted to a device with a 
smaller character set: 

• Lowercase alphabet! cs> including national use alphabetic substitutions, 
are folded into the corresponding uppercase alphabetic. 
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• All other unsupported graphics are folded to the graphic specified by SGEA 
(set graphic error action). Hyphen (-) is the substitute graphic if SGEA 
i s not used. 

No error codes are sent if an unsupported graphic is received. 



UNEXPECTED OUTPUT I4ITH CONTIGUOUS BACKSPACES 

The automatic new line function can cause a BS control to occur at an unpre- 
dictable position relative to the physical end of the line when contiguous BS 
controls are found in the data stream. Since the BS control is a no-op if the 
presentation position is at left margin, contiguous BS controls should be 
avoided. 

There are no error responses as a result of the misuse of the backspace func- 
tion. If an error occurs, however, it may be detected by examination of the 
printed output. 



SCS DEFAULTS 



An SCS control may be treated in one of three ways: 

1. The code is recognized, and the function is performed. 

2. The code is recognized, but a default is taken, and the specified func- 
tion is not performed. 

3. The code is not supported and a negative response is returned. 

A particular- code is supported in the case of either (1) or (2) above? both 
require hardware or software support to recognize the code. The difference 
is in whether an implementation can perform the function or must execute a 
default. 

Figure 1-3 shows the defaults. 

Taking default action for SCS controls specified by a single code point is 
straightforward. Controls with multiple control points sr& more complicated. 
Some controls, such as the controls based on SEL (X*04'), are 2-byte 
sequences in which the second byte is a valid graphic character. Taking a 
default for such a code could cause an extraneous graphic character to be 
printed. Other SCS controls include binary value parameters. If they Bre 
not recognized as value parameters, unpredictable results could occur (they 
could be misinterpreted as valid SCS controls). 

Controls that contain binary parameters include PP (presentation position), 
POC (program operator communication), TRN (transparent), and the controls 
based on X'2B' (CSP) as the first byte of the control. 

Note: If a control is not included in Figure 1-3, refer to the control 
sequence prefix entry in the figure. 



SECOND-LEVEL DEFAULTS 



A default for a particular SCS control may, in turn, take a second default 
For example, IR defaults to RNL, which may further default to NL. 
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Control 

Backspace 

Bell 

Carriage return 

Control sequence prefix 

Customer use 1 

Customer use 3 

Device control 1 

Device control 2 

Device control 3 

Device control 4 

Enable presentation 

Expanded backspace 

Expanded space 

Form feed 

Graphic escape 

Horizontal tab 

Indent tab 

Index return 

Inhibit presentation 

Interchange file separator 

Interchange group separator 

Interchange record separator 

Interchange unit separator 

Line feed 

New line 

Null 

Presentation position 

Program operator communication 

Repeat 

Required form feed 

Required new line 

Required space 

Secure string ID reader 

Select left platen 

Select magnetic encoder 

Select right platen 

Set chain image 

Set graphic error action 

Set horizontal format 

Set line density 

Set translation table 

Set vertical format 

Subscri pt 

Substi tute 

Superscri pt 

Swi tch 

Syllable hyphen 

Transparent 

Unit backspace 

Vertical channel select 

Vertical tab 

Word underscore 



Abbr 



Code 



BS 


16 


BEL 


2F 


CR 


OD 


CSP 


2B 


CU1 


IB 


CU3 


3B 


DC1 


11 


DC2 


12 


DC3 


13 


DC4 


3C 


ENP 


14 


EBS 


36 


ESP 


El 


FF 


OC 


GE 


08 


HT 


05 


IT 


39 


IR 


33 


INP 


24 


IFS 


1C 


IGS 


ID 


IRS 


IE 


IUS 


IF 


LF 


25 


NL 


15 


NUL 


00 


PP 


34 


POC 


17 


RPT 


0A 


RFF 


3A 


RNL 


06 


RSP 


41 


SSR 


0450 


SLP 


04C1 


SME 


046n 


SRP 


04C2 


SCI 


2BD1 


SGEA 


2BC8 


SHF 


2BC1 


SLD 


2BC6 


STT 


2BD1 


SVF 


2BC2 


SBS 


38 


SUB 


3F 


SPS 


09 


sw 


2A 


SHY 


CA 


TRN 


35 


UBS 


1A 


VCS 


04nn 


VT 


0B 


WUS 


23 



Default 

No-op 

No-op 

New line 

No default 

No-op 

No-op 

No-op 

No-op 

No-op 

No-op 

No default 

Backspace 

Space 

New line 

No default 

Space 

Tab 

Required new line 

No default 

New line 

New line 

New line 

Space 

New line 

No default 

No-op 

No-op 

No-op 

Bell 

Form feed 

New line 

Space 

No default 

Left platen 

No-op 

Left platen 

No-op 

No-op 

No-op 

No-op 

No-op 

No-op 

No-op 

Space 

No-op 

Bell 

Hyphen 

No-op 

No-op 

Line feed 

Line feed 

No-op 



Figure 1-3. Defaults of SCS controls. 



MULTIPLE-CHARACTER-SEQUENCE DEFAULTS 

SCS controls containing more than one 1-byte character* and SCS controls with 
parameters except for SSR (secure string ID reader), default to no-op. (SSR 
does not have a default.) Implementations that choose to take these defaults 
must decode and ignore the entire sequence. Otherwise, a negative response 
may be returned. 
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SCS CODE POINTS 



SCS code points are shown in Figure 1-4. 
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Figure 1-4. SNA character string (SCS) code points, 
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PART 2 CHAPTER 2; SNA 3270 DATA STREAM 



This chapter contains criteria used to select functions of the SNA 3270 data 
stream. It shows how those functions are grouped to obtain compatible sets 
of function within IBM products. It does not define the formats and proto- 
cols of the SNA 3270 data stream; these are defined in 3270 Data Stream 
Programmer's Reference. 

This chapter contains detailed information. You may need to read 3270 Data 
Stream Programmer's Reference before reading this chapter. 

The 3270 data stream consists of user-provided data and commands which are 
transmitted between the primary logical unit (PLU) and the secondary logical 
unit (SLU) of an LU-LU session. Control information* which governs the way 
data is handled and formatted, is also transmitted. 

The SNA 3270 data stream is the only data stream used on LU-LU session types 2 
and 3. It is an optional data stream on LU-LU session types and 6. The 
data stream supports both display and printer applications. 

An application program communicates with a display operator using one of two 
methods. In one method, the display surface is left unformatted by the 
application program, and the operator uses it in a free-form manner. In the 
second, the display surface is completely or partially formatted (organized 
or arranged into fields), and the operator enters data in the fields. 

The data stream allows the application programmer to divide the display 
surface into one active area and, optionally, one or more reference areas. 
Each area is called a partition. The partition that is active contains a 
cursor, and it is the only partition in which the operator can enter data or 
requests. 

Each function of the SNA 3270 data stream can be viewed as being contained in 
a function set. In order to implement a function in any given function set, 
you must implement all of the operations defined by that set, and all opei — 
at ions defined by previous sets in the hierarchy. 



FUNCTION SETS OF THE DATA STREAM 

The rules for defining function sets used in IBM products are based on the 
structure shown in Figure 2-1. 

In order to implement a function in any given set in this structure, you must 
implement all of the operations defined by that set and all operations in 
previous sets. You may implement one or more sets for each device. 

Thus, an implementor selects function sets for a product as follows: 

1. Select the functions that you want in your product. 

2. Select those function sets that support the chosen functions, and trace 
upward through the set structure. The operations defined by that set, 
and all the operations in previous sets, form a consistent group of func- 
ti ons. 

3. Repeat step 2 as required to define all sets supported by the product. 

The functions obtained by each function set are summarized in Figure 2-1. 
Items not applicable or partially applicable to printers are noted. More 
detailed descriptions are included below. When a detailed description 
contains a note, such as Note 2, the note is explained in Figure 2-1 (Part 2 
of 2). 
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BASE 








EBASE 






















FIELD 
<attr> 




CHAR 
<attr> 
Note 2 




MULTI 
Note 1A 
































ALT 






MULTI 
Note IB 
























EXSF 
























ALT 




DUAL 




MULTI 
Note 1C 
























PARTN 




SCRLL 
































MPARS 






















16BIT 




























FORMT 






BPARS 




































MSRCTL 




MENCD 





Note It If the MULTI set is chosen, the attribute types selected for (attr) 
must include character sets. Character sets can be selected using: 

1A. Extended field attributes or character attributes (Note 1A above) 
IB. Extended field attributes (Note IB above) 
1C. Graphic Escape characters (Note 1C above) 

Note 2: Validation cannot be specified as a character attribute; it must be 
specified as a type within the extended field attribute. 

Note 3t If the MPARS set is not supported, PID must equal 0. 

Figure 2-1 (Part 1 of 2). Function set structure of the SNA 3270 data stream. 
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SET NAME 


QUERY REPLIES 


FUNCTION 


BASE 




All SNA 3270 commands except WSF and 
all orders except SA, SFE, and MF 


EBASE 


Usable Area 


WSF (Write Structured Field) command 
Read Partition (Query operation only) 
WCC using Reset bit 


EXSF 


Usable Area 
(EXSF flag = 0) 


Outbound 3270DS 
Erase/Reset 


FIELD 


<attr> 

Reply Modes = 

EXTENDED FIELD 

(Note 1) 


SFE <attr> 
MF <attr> 

Set Reply Mode = EXTENDED FIELD 
(Note 1) 


CHAR 


<attr> 

Reply Modes = CHAR 
(Note 1) 


SA <attr> 

Set Reply Mode = CHAR <attr> 
(Note 1) 


ALT 


Character Sets 
(ALT flag on) 


Graphic Escape Character (X'OS*) 


DUAL 


Character Sets 
(DUAL flag on) 


Define Alternate Character Set 


MULTI 


Character Sets 
(MULTI flag on) 


Load Programmed Symbols 


PARTN 


Partitions (n=l) 
(Note 1) 


Create Partition 

Read Partition (RM, RMA, RB 

operations) (Note 1) 
Reset Partition 
Inbound 3270DS 


SCRLL 
(Note 2) 


Parti ti ons 

(Scroll flag(s) on) 


Create Partition with 

presentation space > window 
Set Window Origin 


MPARS 
(Note 2) 


Partitions (n>l) 


Activate Partition 
Destroy Partition 


16BIT 


Usable Area 
(16-bit flag on) 


SBA, RA, EUA - 16 bit 
Create Partition - 16 bit 


BPARS 
(Note 1) 


Partitions (n>l) 


Restrictions on certain commands, 
orders, and structured fields 


FORMT 
(Note 3) 


Format Presentation 


Select Format Group 
Present Absolute Format 
Present Relative Format 


MSRCTL 
(Note 2) 


MS Device Control 
(TYPE = X'01') 


MS Device Control 
(TYPE = X*01') 


MENCD 
(Note 2) 


MS Device Control 
(TYPE = X'02*) 


MS Device Control 
(TYPE = X'02') 


Note 1: Limited application to LU T3. 

Note 2: Not applicable to LU_T3. 

Note 3: If MPARS is not supported> PID must equal 0. 



Figure 2-1 (Part 2 of 2). Function set structure of the SNA 3270 data stream, 
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BASE (BASE) 



This set must be implemented and the device must support: 

• The following 3270 commands: 

- Read Buffer (RB) 

- Read Modified (RM) 

- Read Modified All (RMA) 

- Write (W) 

- Erase/Write CEW) 

- Erase/Write Alternate (EWA) 

- Erase All Unprotected (EAU) 

• The following 3270 orders: 

- Start Field (SF) 

- Set Buffer Address (SBA) 

- Insert Cursor (IC) 

- Program Tab (PT) 

- Repeat to Address (RA) 

- Erase Unprotected to Address (EUA) 

• 12-bit addressing 

• Write control character (WCC) with reset bit always 1 
and start printer bit supported 



EXTENDED BASE (EBASE) 



If this set is implemented, the device must support: 

• All 3270 commands, including Write Structured Field (WSF), and all 
orders except SA, SFE, and MF 

• Read Partition structured field (query operation) 

• Query Reply (Usable Area) structured field with 12/14-bit addressing 

- 14-bit addressing is optional 

• WCC with reset bit set to or 1 

• SBA, RA, EUA, with 12/14-bit addressing (14-bit addressing optional) 



EXTENDED STRUCTURED FIELD SUPPORT (EXSF) 

If this set is implemented, the device must support: 

• Query Reply (Usable Area) with the EXSF flag set to B f f 

• Outbound 3270DS structured field 

• Erase/Reset structured field 



EXTENDED FIELD ATTRIBUTES (FIELD) 

If this set is implemented, the device can respond to a query with the struc- 
tured fields that describe the attribute properties supported, from the 
f ollowi ng: 

• Query Reply (Color) 

• Query Reply (Highlight) 

• Query Reply (Character Sets) 

• Query Reply (Field Validation) (Note 2) 

In addition, the device must support: 

• Query Reply (Reply Modes) structured field (Note 1) 

- field and extended-field modes 

• Set Reply Mode structured field (Note 1) 

- field and extended-field modes 

• Start Field Extended (SFE) order - 3270 and <attr> 

• Modify Field (MF) order - 3270 and <attr> 
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CHARACTER ATTRIBUTES (CHAR) 



If this set is implemented, the device supports the attribute types indicated 
by the query replies supported by its previous sets. In addition, the device 
must support: 

• Query Reply (Reply Modes) structured field (Note 1) 

- character mode 

• Set Reply Mode structured field (Note 1) 

- character <attr> 

• Set Attribute (SA) order - <attr> 



MULTIPLE CHARACTER SET CAPABILITY (MULTI) 

If this set is implemented, the device must support the functions defined in 
the appropriate previous sets (FIELD, CHAR or DUAL). In addition, it must 
support the following: 

• Query Reply (Character Sets) structured field 

- with MULTI flag set on 

• Load Programmed Symbols structured field 



ALTERNATE CHARACTER SET (ALT) 



If this set is implemented, the device must support: 

♦ Query Reply (Character Sets) structured field 

- with ALT flag set on 

• Graphic Escape Character (X f 08 f ) 



DUAL LANGUAGE CAPABILITY (DUAL) 



If this set is implemented, tlje device must support: 

• Query Reply (Character Sets) structured field 

- with DUAL flag set 

• Define Alternate Character Set structured field 



PARTITIONS (PARTN) 



If this set is implemented, the device must support 

• Query Reply (Partitions) structured field 

- with n=l 

• Create Partition structured field 

• Inbound 3270DS structured field (Note 1) 

• Read Partition structured field (Note 1) 



SCROLLING (SCRLL) (NOTE 2) 

In addition to the partitions functions found in previous sets, the device 
must support: 

• Query Reply (Partitions) structured field 

- with scroll flag(s) set 

• Set Window Origin structured field 
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MULTIPLE PARTITIONS CMPARS) (NOTE 2) 

In addition to the partitions functions found in previous sets* the device 
must support: 

• Query Reply (Partitions) structured field 

- wi th n>l 

• Activate Partition structured field 

• Destroy Partition structured field 



16-BIT ADDRESSING C16BIT) 

In addition to the partitions functions found in previous sets, the device 
must support these structured fields and orders (with 16-bit addressing): 

• Query Reply (Usable Area) structured field 

• SBA, RA, and EUA orders 

• Create Partition structured field 



BASIC PARTITIONS (BPARS) 

If this set is implemented* the device must support: 

• Query Reply (Partitions) 

- with the unbuffered and protected partition flags set on 

• Create Partition structured field 

- parameters for unbuffered and protected partitions. 

• The following: 

- Read Buffer. Read Modified- Read Modified All commands 

- Erase All Unprotected command 

- Insert Cursor order 

- Program Tab order 

- Erase Unprotected to Address order 

- Modify Field order 



FORMAT PRESENTATION (FORMT) 



If this set is implemented, the device must support: 

• Query Reply (Format Presentation) structured field 

• Select Format Group structured field 

• Present Absolute Format structured field 

• Present Relative Format structured field 



MSR CONTROL (MSRCTL) 

If this set is implemented, the device must support: 

• Query Reply (MS Device Control) structured field (with TYPE = X*01 f ) 

• MS Device Control structured field (with TYPE = X'01') 



MAGNETIC ENCODER (MENCD) 

If this set is implemented, the device must support: 

• Query Reply (MS Device Control) structured field (with TYPE = X'OZ') 

• MS Device Control structured field (with TYPE = X , 02») 
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PART 2 CHAPTER 3; STRUCTURED FIELD FORMATS 



This chapter contains structured fields used by the SNA components described 
in this book* except for those structured fields used exclusively by the SNA 
3270 data stream. Those readers who are using the 3270 data stream should see 
5270 Data Stream Programmer's Reference for all structured field formats for 
that data stream. 

The syntax for structured fields permits variable-length data and controls to 
be encoded in such a way that the receiver of a data stream can decompose a 
sequence of fields into its component fields without having to scan every 
byte. Variable length structured fields are achieved by providing a length 
as the first parameter of the structured field, thus: 



|< structured field 1 >|<-- 



structured field 2 >| 



length 1 


ID 


i nf ormati on 
field 


length 2 


ID 


i nf ormati on 
field 



length 1 



■>|<- 



length 2 



>l 



Note; Some structured fields may specify a value of zero in the length field. 
A length of zero indicates that: 

• The length of the structure was not determined prior to transmission. 

• This is the last or only structured field in the request unit (RU). 

• The length of the structured field should be determined using a communi- 
cation-control function, for example, the RU ' s EC (end chain) indicator. 

A length field containing zero is restricted to those structured fields that 
have "XX" as the second byte of the ID in following table. 

Structured fields do not span chains; that is, it is an error condition 
(length error) if the chain ends before a structured field's length count is 
satisfied. Also, control sequences (for example, set attribute) do not span 
structured fields; it is an error condition if the entire control sequence 
does not appear in the same structured field. 

The structured fields in this chapter sre described in alphabetical order. 
The following list shows them in hexadecimal order by their identification 
(ID) field. 

ID NAME 

01 XX Read Partition - Query 
06 XX Load Programmed Symbols 

10 30 Request Recovery Data 

10 31 Recovery Data 

10 32 Set Checkpoint Interval 

10 33 Restart 

41 XX SCS Data 

81 81 Query Reply (Usable Area) 

81 85 Query Reply (Character Sets) 

81 86 Query Reply (Color) 

81 87 Query Reply (Highlight) 

81 A0 Query Reply (Device Characteristics) 

Each of these structured fields is defined below. 

Structured field type codes not defined are reserved and are rejected (SNA 
sense code X'1003*). Unless specifically stated to the contrary, any 
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bi ts/f i elds classif i ed as reserved must be checked for zero value; nonzero 
values are rejected (sense code X*1003'). 

SNA sense codes associated with structured fields are listed on page 184. 



LOAD PROGRAMMED SYMBOLS (LOAD PS) 

FUNCTION 

Defines additional coded graphic character sets* and then loads that symbol- 
and charactei — definition data into a specified storage area i n the device. 

This structured field causes one or more characters to be loaded into contig- 
uously-addressable slots in the specified storage area. Each storage area 
contains 191 contiguously-addressable slots, which are associated with data 
stream code points X'40' through X'FE*. The slot associated with X'40* 
cannot be loaded* and contains a blank. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2 




X'06' 


Load Programmed Symbols (Load PS) 


3 




2 

(3-7) 

3 

4-7 


FLAGS 
BASIC/ EXT. 
B'O' 
B'l' 

CLEAR 
B^o" V 
B'l' 

SKIP 
B'O' 
B'l' 

TYPE 

X'5» 
X'6' 

others 


Basic or extended form 

- Basic form (only bytes through 6 present) 

- Extended form (length determined by byte 7) 

vicar i w = tn. slu( ayti cJrtscl 

- Do not clear PS-set storage area 

- Clear the specified PS-set 
storage area prior to loading the 
character data in this structured field 

Skip suppress (See Note 2) 

- Suppression not required 

- Suppression required 

PS data format type: 

Reserved 

Format: 

- Column loading (from left to right) 

- Type X*5' compressed 

- Reserved 


4 




LCID 


Local character set ID 

- Use X'40' to X'EF* . 

- Use X'FF' to indicate that RWS 
(read-write storage) associated 

with this LCID is free (not assigned). 

- Other values are reserved. 


5 




CHAR 


Beginning code point 
- X»41 through X'FE' 


6 




RWS 


PS-set storage number (X'02' through X'07') 
in RWS (read-write storage) 
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Bytes 7 to 12 are parameters for the extended form of Load PS. 



BYTE 


BIT 


CONTENT 


MEANING 


7 




P. LENGTH 


Length of parameters for extended form, 
including the length parameter. The 
parameters defined below are progressively 
included by specifying the appropriate 
length. Omitted parameters are assumed to 
have the architecturally defined default 
indicated by the zero value for that 
parameter. 


8 




1 

2 

3-7 


APA 
B'O' 

B'l' 

CB 

B'O' 

B'l' 

OB 

B'O' 

B'l' 

Reserved 


All points available 

- All points available 

- Not all points available 

LCID compare 

- LCID compare 

- No LCID compare 

Operator selectable by PS key 

- Operator selectable 

- Not operator selectable 

Must be zero 


9 




LUI 


Number of X-units in character cell 


10 




LH 


Number of Y-units in character cell 


11 






Reserved 


12 


0-4 
5-7 


Reserved 

COLOR 

B'000* 

B'001* 

B'010' 

B'100' 

other 


Must be zero 

Color planes 

- All planes 

- Blue plane 

- Red plane 

- Green plane 

- Reserved 



Note 1 : Values for parameters other than those shown above are rejected; 
invalid parameter values are also rejected. (See "Sense Code Table" on page 
1S4.) 



Note 2; The lost space resulting from setting of the skip suppress to B'l 
made up following the last display/print line. That is, the last 
display/print line moves up from the bottom of the physical presentation 
space. For a printer, setting of skip suppress to B'l* must not result in 
loss of forms sync following a form feed (FF) or forms overflow. 



i s 



The PS data follows in the format described in bits 3-7 of byte 3. 



BYTE 


BIT 


CONTENT 


I MEANING 


m-n 




DATA 


PS data (charactei — definition data) 



OPERATION 
1 



The extended-form bit in byte 3 indicates whether this structured field 
is of the extended form, that is, contains bytes 7 through 12. The 
extended form contains additional information associated with copy opei — 
ations, character cell size, and color. If the half-session does not 
support the extended form and this bit is set to 1, the data stream is 
rejected (invalid parameter, sense code X'1005'). 
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2. If skip suppression is on, any row on the usable area containing charac- 
ters from this character set will have the skip suppressed that would 
normally follow that row. The characters on the following row will then 
be vertically adjacent to the characters on the current row. If the skip 
suppress flag is not set, then no skip suppression is required for chai — 
acters from this character set. 

3. The RWS number indicates the physical RWS to be loaded. There is a fixed 
relationship between the physical RWS number and the attribute selection 
keys defined for PS. The value in CHAR indicates the first slot to be 
loaded, and must be in the range X»41* through X'FE' . If CHAR < X»41' or 
CHAR > X'FE', the data stream is rejected (invalid parameter, sense code 
X'1Q05'). 

If the CLEAR flag is set on, all slots in the specified RWS are cleared, 
then the character definitions in the data portion of the structured 
field, interpreted according to the data format type Cbyte 3), are loaded 
into contiguously-addressable slots in the PS RWS, starting at the posi- 
tion defined by CHAR. 

If the data type specifies compressed data (type 6), the data is first 
decompressed. (The compression-decompression function is discussed in 
the literature published by products that have implemented Load PS.) 

For data of type 5 or type 6, each set of LH contiguous bits defines one 
column of a character cell. LW such contiguous columns define a charac- 
ter as a LW by LH matrix of dots, where LW is the width of the character 
cell and LH is the height of the character cell. If LW and LH are not 
supplied in the extended form, or if they are supplied and set to zero, 
the values of LW and LH &re determined by the device. 

Loading of character definitions continues until either: 

• The data is exhausted. In this case, the last complete cell definition 
in the data is loaded. If there are any excess bits, they are ignored 
and a negative response (sense code X'1005*) is returned. 

♦ The slot corresponding to X'FE* is loaded. Excess data is ignored and a 
negative response (sense code X'1005') is returned. 

4. The LCID is a one-byte code identical to the value byte definition for a 
character set identified by a set attribute control in an SNA character 
string. The LCID specified in this structured field is released from any 
previously associated PS RWS number. The PS RWS number released is 
assigned LCID = X'FF'. This is not done until the LCID specified in this 
structured field is assigned to the associated RAM. 

5. The RWS (read-write storage) number specified in this structured field is 
released from any previously assigned LCID. Any subsequent reference to 
this released LCID will be an error condition. 

6. An LCID of X'FF' indicates that this PS RWS is free (not assigned). In a 
printer, a PS RWS with LCID = X'FF' may be overlaid when PS data is 

copi ed. 

On a Load PS, where an error condition is detected before the contents of 
the associated RWS is altered, a negative response is sent but the LCID 
is not changed. Where the error condition occurs during the update of 
the RAM, the negative response is sent and the LCID is updated to that 
specified in Load PS. The above applies to a sequence of Load PS struc- 
tured fields sent after an FMH-1 that specifies that structured fields 
follow. Also, any sequence of Load PS structured fields following the 
failing Load PS is not executed. 

7. The APA bit, when set to 1 (not APA), implies that fewer than all points 
may be displayed or printed to allow a performance gain for specific 
devi ces. 

8. When the CB bit is set to 0, and a local copy is initiated, the LCID of 
this character set is compared with character set LCIDs in the printer to 
determine whether or not there is a match. If the LCIDs match and the CB 
bits are both zero, the copy operation is performed using the correspond- 
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ing LCID in the printer. If not* characters from the base character set 
of the printer are used. 

When the CB bit is set to 1, the LCID of this character set is not 
compared with LCIDs of character sets in the printer. The copy operation 
is performed using the base character set of the printer. 

When the printer can accept character sets from the display during a copy 
operation, and there is no corresponding LCID in the printer, the charac- 
ter set may be copied independent of the setting of the CB bit. 

9. When the OB bit is set to 1* it signifies that this character set is 
intended for output only. Thus, the PS selection key normally associated 
with the RWS containing this character set cannot be enabled by the 
terminal operator while the key is connected to this LCID. Selection of 
individual character sets can thus be disabled, even though the Set Reply 
Mode structured field allows character set selection. When the Set Reply 
Mode structured field disables character set selection, selection is 
disabled for all character sets, independent of the setting of the OB bit 
for each character set. 

10. If LW and LH for the character cell dimensions are specified and are 
nonzero, and LW is not more than the maximum character cell width 
supported by the device, and LH is not more than the maximum character 
cell height supported by the device, then the character cells defined by 
LW and LH are loaded into the specified PS RWS so that the first bit 
addresses the upper left-hand corner of the character slot. 

If either LW or LH exceeds the maximum slot size supported, the struc- 
tured field is rejected (invalid parameter, sense code X'1005'). 

If LW and LH are not specified or are set to zeros, a device default char- 
acter cell size is used to determine the character cell size in the PS 
data. 

11. A character set with triple-plane capability has three color planes into 
which characters may be loaded. For any code point (X*41* to X'FE') 
within the character set, each plane may be loaded independently; that 
is, a different character definition may be loaded into each of the color 
planes in the character set for that code point. 

For a triple-plane character set, if the COLOR field is B*001*, B*010', 
or B'100', the character set data is loaded only into the specified chai — 
acter slots in that plane. Other COLOR values are reserved and rejected. 

For a triple-plane character set, if the COLOR field is B'000', the chai — 
acter set data is loaded into the specified character slots in all three 
planes. 

For a single-plane character set, if the COLOR field is 8*001*, B*010», 
or B'100', the data stream is rejected. 
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QUERY REPLY 



FUNCTION 

Transmits a response to a query request. The query request is sent in the 
Read Partition structured field. (See "Read Partition" on page 177.) 

FORMAT 



BYTE 


CONTENT 


MEANING 


0-1 


L 


Length of this structure 


2 


X'81* 


Query Reply 


3 


REPLY 
CODE 


Reply identifying code: 

X'81' = Usable area 

X'85' = Character set 

X'86 f = Color 

X»87* = Highlight 

X f A0 f = Device characteristics 


4-n 


PLIST 


Parameter li st 



OPERATION 

In reply to a query, the device transmits inbound a set of structured fields 
that describe the device features. 

Each structured field has an ID of X f 81nn'» where nn is the reply code identi 
fying the feature. 

PLIST is a variable-length parameter list. For the parameter list for each 
reply code* see the specific query reply in the definitions that follow. 
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QUERY REPLY (CHARACTER SETS) 



FUNCTION 



Transmits information about (1) each character set supported? and (2) the 
ability of the device to support: 

• The Load PS structured field 

• A graphic escape character 

The SLU sends this form of query reply when responding to a Read Partition 
structured field indicating query. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2 




X'Sl" 


Query Reply 


3 




X f 85» 


Character sets 


4 




1 
2 

3 
5-7 


FLAGS 
ALT 
B'O' 
B'l* 

RES 

MULTI 
B*0 f 

B'l ! 

EXT 

B'O* 

B'l' 

MS 
B f 0» 

B'l' 

RES 


Graphic escape (GE): 
GE not supported 
GE supported 

Reserved 

Multiple character set capability: 
Load PS not supported 
Load PS supported 

Extended form of Load PS: 

Load PS extended form not supported 

Load PS extended form supported 

Matrix size 
Fixed-size matrix 
Variable-size matrix 

Reserved 


5 




RES 


Reserved 


6 




SDW 


Default matrix width for Load PS 


7 




SDH 


Default matrix height for Load PS 


8-11 




FORM 


Supported Load PS format types; bit encoded 
(If bit i = It then type i supported) 


12 




DL 


Length of each descriptor 



The base part is followed by one or more character set descriptors, each 
defining the characteristics of one character set located in either read-only 
storage or read-write storage. The length of each descriptor is contained in 
DL . Its format is: 
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1 




SET 


Device-specific character set ID (number 
of the read-only or read-write storage) 


c. 




FLAGS 









LOAD 


Loadable: 






B'O' 


Nonloadable character set 






B'l' 


Loadable character set 




1 


TRIPLE 


Triple plane: 






B'O' 


Single-plane character set 






B'l' 


Triple-plane character set 




2 


CHAR 


Character representation: 






B'O* 


One-byte coded character set 






B'l* 


Two-byte coded character set 




3 


CB 


Compare bit: 






B'O' 


LCID compare 






B'l* 


No LCID compare 




4-7 


RES 


Reserved 


3 




LCID 


Local character set ID 


4-15 




RES 


Reserved 



OPERATION 

The parameters in the base describe the device's capability to support chai — 
acter sets, as follows: 

• The following description of the FLAGS byte in the base (byte 4) refers to 

a.i__ -c. . „ ..j- ; _ _ _ _-i- _ _..__.. _.l__i i_.. xi _i _ . . : 

viib iniiwv.lv/ii aev.3 3U^K U > v.tsvj uy v.u« usv lus. 

ALT indicates that the device subset includes the ALT node. 

MULTI indicates that the device subset includes the MULTI node. 

EXT indicates that the device supports the extended form of the Load PS 
structured field. Thus, EXT = B'l' only if MULTI = B'l'. 

MS indicates that the device supports a matrix size that is related to 
the character set size, that is, the parameters SW and SH are present in 
each descriptor. If the device supports nonmatrix characters (as indi- 
cated in byte 5 bit 1 of Query Reply (Usable Area)), bytes 6 and 7 of the 
base (SDW and SDH) are not applicable and must be set to zero. As with 
EXT, MS = B'l* only if MULTI = B'l'. 

• SDW and SDH define the default matrix size. (See also SW and SH, below.) 

• FORM defines the Load PS format types supported by the device.^ This field 
is a 32-bit field. Each bit corresponds to a format type that can be speci- 
fied in Load PS (See TYPE field of Load PS on page 164.) Thus, if bit i = 1 
in FORM, the device supports -format type i in Load PS. 

Currently, Load PS format types 5 and 6 are defined for LU_T1. Bit values 
B*lllll..l f of the first byte of the field are reserved, as are bytes 2 
through 4. 

• DL defines the length of each descriptor (in bytes). 

The parameters in each descriptor define the characteristics of a character 
set, as follows: 

• SET defines the device specific ID. For a loadable set, this is the value 
specified in byte 6 of Load PS. SET also defines the key that can be used 
by the operator to select this character set. 

• LOAD indicates that this character set is loadable. 
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• TRIPLE indicates that this character set has one or three planes. 



• CHAR indicates that this is a 1- or 2-byte coded character set. 

♦ CB indicates whether this character set can be compared for copy, 
the CB field and subsequent discussions in Load PS on page 164.) 



(See also 



LCID identifies the local character set ID currently connected to this 
character set. The ID may not identify uniquely the contents. A value of 
X*FF' indicates that this PS set is free (not assigned). LOAD PS allows an 
LCID to be connected to a loadable character set. The LCID is then the data 



stream value used in SA SNA character string controls to identify cha 
ters from this set. Nonloadable character sets have a default LCID 
assigned to them by the device in the range X'FO' through X'FE' 



rac- 



QUERY REPLY (COLOR) 



FUNCTION 



Transmits the color properties of the device if the device accepts or 
supports some set of color attribute values. 

The device sends this form of query reply when responding to a Read Partition 
structured field indicating query. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2 




X'81' 


Query Reply 


3 




X'86« 


Color 


4 




FLAGS 











Reserved 




1 


B»0» 


Printer only - A one-color 
ribbon is not loaded 






B»l' 


Printer only - A one-color 
ribbon is loaded 




2-7 


Reserved 




5 




N 


Length of color attribute list 
(N = number of CAV/COLOR pairs) 


m 




CAV(n) 


Color attribute value accepted by 
the device 


m+1 




CID(n) 


Color identifier of the color 
displayed/printed for CAV(n). 
Color identifiers are: 






X f 00' 


Default color 






X'Fl* 


Blue 






X'F2' 


Red 






X»F3 f 


Pink 






X»F4* 


Green 






X'F5» 


Turquoi se 






X'F6' 


Yellow 






X'F7» 


Neutral 






X'FS* 


Orange 






X»F9» 


Black 






X'FA» 


White 
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OPERATION 

The parameters CAV(n) are all those color attribute values that are accepted 
by the device without causing a negative response. 

The parameters CID(n) identify the colors that are displayed or printed by 
the device for each of the accepted color attribute values. The device must 
either display the color whose architected color identifier is the same as 
the color attribute value or display the device default color. Except for 
CAV(n) = X' 00 ' , translationby the device of a color attribute value to a 
color different from that architected for the specific color attribute value 
is not allowed, that is, the value of CID(n) can only be equal to the value of 
CAV(n) or to X'OO'. No other values are allowed. 

The CAV/CID pairs are repeated for each of the data stream values accepted by 
the devi ce. 

The color associated with the CAV(n) value of X'F7* defines the default color 
that is displayed/printed when a single plane character set is referenced; 
the associated CID(n) value may be any of the values in CAV(n) including 
X'OO'. The value X'F7' for CID(n) indicates the default color is neutral. 
Neutral means black or white. 

The CAV(n) value of X'OO' may have an associated CID(n) value of any of the 
defined values except X'OO'. 

All devices that send Query Reply (Color) are required to have the values 
CAV1 = X'OO*, CID1 = value associated with the the device default color, as 
the first entry in the CAV/CID pairs list. 

Query Reply (Color) Example: 



CAV(n) 
ATTR VALUE 


CID(n) 
COLOR IDENTIFIER 


X'OO* 


X'F7» 


X'Fl' 


X'Fl' 


X'F2' 


X'F2' 


X'F3» 


X'OO' 


X'F4' 


X'F4* 


X'F5' 


X'OO' 


X*F6' 


X'OO' 


X'F7' 


X'OO' 
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QUERY REPLY (DEVICE CHARACTERISTICS) 

FUNCTION 

Transmits the device's ability to support SNA Character String (SCS) func- 
ti ons. 

The device sends this form of query reply when responding to a Read Partition 
structured field indicating query. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2 




X*81* 


Query Reply 


3 




X'AO' 


Device Characteristics 


4-n 






Function descriptor structured fields 



The base part 
Set Print 



is followed by a descriptor: 
Density (SPD) descriptor 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2-3 




X'llOV 


SCS X'2B* identifier 


4-5 




X'D229» 


Set Print Density descriptor 


6 




X f 00» 


SPD is supported, default value is used 


7-8 




X'OOnn* 


Default value for print density (for 
example, X'OOOA' is 10 characters per inch) 


9 




X'02» 


CD (character density) parameter length 


10 




X»60' 


The CD parameter is present sometimes, 
it only takes discrete values, 
and it appears only one time 


11 




X'nn' 


Number of di screte values supported by 
the device 


12-n 






The discrete CD values supported 



OPERATION 

The function descriptor is included in Query Reply (Device Characteristic) to 
indicate how an SCS function is supported. 
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QUERY REPLY (HIGHLIGHT) 



FUNCTION 

Transmits the types of highlighting supported by the device. 

The device sends this form of Query Reply when responding to a Read Partition 
structured field indicating query. 

FORMAT 



BYTE 


CONTENT 


MEANING 


0-1 


L 


Length of this structure 


2 


X'Sl" 


Query reply 


3 


X f 87 f 


Highlight 


4 


N 


Number of attribute-value/action pairs 


n 


Vi 


Data stream attribute value accepted 


n+1 


Ai 


Data stream action 



OPERATION 

If a device accepts the highlight attribute type* then it must accept attri- 
bute value X*00* (default specification). It may optionally accept other 
attribute values. All accepted values are listed in the query reply. For 
each accepted value* the query reply lists the device action in replies of 
1-byte action codes. The action codes (Ai) are: 

vi rn i li ■»/■ i_:_i_ii_.i_j-x 

/\ ru nunnai vnu n i ynju i Qru i 

X'Fl' Blink 

X f F2 f Reverse video 

X'F^* Underscore 

In addition to the above* the action code may specify X'OO*. The code X'OO* 
indicates that the device action for the corresponding attribute value is the 
same as the action for the attribute value X*00'* that is, the default action 
of the devi ce. 
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An example of Query Reply (Highlight) is: 



BYTE 


CONTENT 


MEANING 


0-1 


X'OOOC 


Length 


2 


X'81 f 


Query reply 


3 


X'87' 


Highlight 


4 


X'04' 


Number of pai rs 


5 


X'OO* 


Attribute value (default) 


6 


X'FO' 


Normal (no highlighting) 


7 


X*F1' 


Attribute value 


8 


X»00» 


Action - default 


9 


X'F2» 


Attribute value 


10 


X'F2' 


Action - reverse video 


11 


X'F4* 


Attribute value 


12 


X*F4* 


Action - underscore 



QUERY REPLY (USABLE AREA) 



FUNCTION 



Transmits the size and characteristics of the screen or page. 

The SLU sends this form of query reply when responding to a Read Partition 
structured field indicating query. 

The screen or page is comprised of a specific number of cells. The number of 
these cells and their size is specified in this query reply. 

A character may be placed in each cell. This character may be taken from any 
of the character sets defined in Query Reply (Character Sets). 

Note: A device may be implemented to allow the cell size to be controlled by 
the host (the host specifies the cell size in a Create Partition structured 
field). In this case; the host-specified value overrides the default 
described above. 
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FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2 




X'81' 


Query reply 


3 




X'81* 


Usable Area 


4 


0-1 
2 

3 
4-7 


FLAGS 
RES 

EXSF 

B'O' 
B'l' 

HC 

B'O* 

B'l' 

ADDR 
X'F' 
Other 


Reserved. 

Structured field usage: 

SCS Data supported 
SCS Data not supported 

Hard copy characteristics: 
Not a hard copy device 
A hard copy device 

Addressing mode 

Unmapped (no explicit addressing) 

Other values reserved. 


5 



1 

2-7 


FLAGS 

RES 

CHAR 
B'O' 
B'l' 

RES 


Reserved 

Characters 

Matrix characters 

Nonmatrix characters 

(for example* a belt printer) 

Reserved 


6-7 




W 


Width of usable area in cells 


8-9 




H 


Height of usable area in cells 


10 




UNITS 
X'OO' 
X'Ol' 


Unit of measure: 

Inches 

Mi Hi meters 


11-14 




Xr 


Distance between points in 
x direction as a fraction, 
measured in units: 
2-byte numerator 
2-byte denominator 


15-18 




Yr 


Distance between points in 
y direction as a fraction, 
measured in units: 
2-byte numerator 
2-byte denominator 


19 




AW 


No of x-units in default cell 


20 




AH 


No of y-units in default cell 



OPERATION 

EXSF indicates whether structured field support has been configured and is 
executable. 

HC indicates that this is a hard-copy device, that is, a printer. 

CHAR indicates matrix or nonmatrix characters. If CHAR = B'l* (nonmatrix 
characters), bytes 10-20 are not applicable and must be set to zeros. 
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W and H define the size of the usable area in cells of size 
AW, AH). Thus, the total size of the usable area in points 
AH. 



AW x AH (see also 
i s W x AW by H x 



The primary unit of measure is always character cells. Thus, W x H defines 
the maximum number of characters that can be presented in the usable area, 
when characters from a nonloadable set are being use. 

For a printer, W and H ar^t the maximum print position (MPP) and the maximum 
print line (MPL) supported by the hardware. These values correspond to the 
MPP and MPL values in the SNA character string (SCS), On some devices, MPP 
and MPL may be set by the operator. The values returned in this query reply 
refer to the hardware's capability, not to the current setting. 

UNITS, Xr and Yr define the spacing granularity. For example, if the device 
has 72.5 points/inch horizontally and 69 points/inch vertically, the the 
values would be: 



UNITS - X 
Xr - X 
Yr - X 



00' 

00020091 

00010045 



(that 
(that 



1 s, 
i s, 



2/145 decimal) 
1/69 decimal) 



In combination with Load PS, the application can use these parameters to 
present data where precise dimensions are critical. Alternatively, if the 
relati ve dimension (x/y aspect ratio) is critical, the ratio Xr/Yr allows 
this relationship to be controlled. 

AW and AH define the default cell size for the device. They specify the smal- 
lest cell size available for the presentation of characters from any nonload- 
able character set. 

Generally, the values for Xr, Yr, AW, and AH are fixed for a given implementa- 
tion. If the values can be changed, such as by an operatoi — actuated switch 
operation, the values defined are those in effect when a Read Partition (Que- 
ry) i s recei ved. 



READ PARTITION 



FUNCTION 

Queries the device as to its capabilities. 

FORMAT 



BYTE 


CONTENT 


MEANING 


0-1 


L 


Length of this structure 


2 


X'01' 


Read Partition 


3-4 


X'FF02» 


This read is a query operation 



OPERATION 

A set of codes is transmitted to the sender of the Read Partition structured 
field. These codes describe the features on the device. (See "Sense Code 
Table" on page 184 for error conditions.) 
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RECOVERY DATA 



FUNCTION 

Sent from SLU to PLU in response to a Request Recovery Data structured field. 
It contains the recovery data needed by the PLU to recover from the error. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2-3 




X'1031' 


Recovery Data 


4 






Reserved 


5 




1 

2-7 


Flags 


- Vertical format not needed on Restart. 

1 - Vertical format needed on Restart. 

- Horizontal format not needed on Restart. 

1 - Horizontal needed on Restart. 

Reserved 


6 




SLD 


SLD (set line density) parameter in effect at 
the checkpoint. The default value (X'00') indi- 
cates the parameter is not to be reinitialized 
at restart. 


7 




Char. Set 


Character set parameter of SA (set attribute) 
control in effect at the checkpoint. The 
default value CX'OO') indicates the parameter is 
not to be reinitialized at restart. 


8-11 




Verti cal 


Byte offset from Set Checkpoint Interval struc- 
tured field to the SVF (set vertical format) 
control in effect for the checkpoint. If the 
SVF control is within a parameterized string the 
counter points to the control code of the param- 
eter. It is set to zero (0) if no SVF control 
code is received. 


12-13 




V-offset 


Byte offset within the SCB (string control byte) 
string or structured field of the SVF character. 
The offset i s to the uncompressed and uncom- 
pacted character. It is set to zero (0) if the 
SVF character is not within an SCB string or 
structured field. 


14-15 




V-seq' ce 


RU sequence number of the RU containing the SVF 
character. 


16-17 




V-length 


Length of the SVF character string required for 
restart. 
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BYTE 


BIT 


CONTENT 


MEANING 


18-19 




SPD 


SPD (set print density) parameter in effect at 
the checkpoint. The default value CX'0000') 
indicates the parameter is not to be reinitial- 
ized at restart. 


20-23 




Hori zon . 


Same as vertical for SHF (set horizontal 
format) . 


24-25 




H-offset 


Same as V-offset for SHF. 


26-27 




H-seq'ce 


Same as V-sequence for SHF. 


28-29 




H-length 


Same as V-length for SHF. 


30 




Color 


Color parameter of SA (set attribute) in effect 
at the checkpoint. The default value (X'OO') 
indicates the parameter is not to be reinitial- 
ized at restart. 


31 




Hilite 


Highlight parameter of SA in effect at the 
checkpoint. The default value (X'OO 1 ') indicates 
the parameter is not to be reinitialized at 
restart. 


32-33 




Pages 


Number of pages printed since the checkpoint. 


34-35 




Li nes 


Number of lines printed on the page with the 
error. 


36-39 




Chkpoint 


Byte offset from Set Checkpoint Interval struc- 
tured field to the first character after the 
(code point or character) that caused an eject 
to the checkpointed page. If the character is 
within a parameterized string the counter points 
to the control code of the parameters. 


40-41 




C-offset 


Byte offset within the SCB string or structured 
field of the checkpointed character. The offset 
i s to the uncompressed and uncompacted 
character. It is set to zero (0) if the check- 
pointed character is not within an SCB string or 
structured field. If the character is within a 
parameterized SCS control code this is an offset 
to the SCS control code. 


42-43 




C-seq 


RU sequence number of the RU containing the 
checkpointed character. 


44-45 




C-Seqoff 


Byte offset within the RU of the checkpointed 
character. 


46-47 




C-SCSoff 


Byte offset within the parameterized SCS control 
code (for example, TRN) of the checkpointed 
character. It is set to zero (0) if the check- 
pointed character is not within a parameterized 
SCS control code. 


48 




Prime 


Prime compression character in effect at time of 
checkpoint. 



OPERATION 

• Pages 

The pages indicate the number of pages that the SLU has printed since 
checkpoint was taken that is being sent to the PLU. 



the 
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• Li nes 

The lines indicate the number of lines that the SLU has printed since the 
beginning of the page on which the error had been detected. 

• Checkpoint (Chkpoint) 

The checkpoint field is a 4-byte binary counter that indicates the number of 
FM data bytes from the Set Checkpoint Interval structured field to the first 
code point after the code point that caused a page eject to the page for which 
a checkpoint is to be taken. That is* it counts all FM data bytes in the RUs 
following the latest Set Checkpoint Interval structured field. It then 
points to the first code point processed after the printer ejected to the top 
of the page for which the interval count requires a checkpoint. If the eject 
was caused by a parameterized string* the counter points to the control code 
of the parameters (for example* the immediately preceding SCB control code). 

• C-offset 

C-offset is a 2-byte binary counter that indicates the position within a 
compression/compaction SCB string or structured field of the actual check- 
point character. It points to the uncompacted/uncompressed position of the 
character* not the compressed/compacted posi ti on. 

This field is zero (0) if the checkpoint field points to the exact check- 
pointed character. 

• C-SCS-offset (C-SCSoff) 

C-SCS-offset is a 2-byte binary counter that indicates the position within a 
parameterized SCS code of the checkpointed character. 

This field is set to zero (0) if the checkpointed character is not within a 
parameterized SCS code. 

•Vertical 

The vertical field is a 4-byte binary counter that indicates the byte offset 
from the Set Checkpoint Interval structured field to the SVF code point in 
effect for this checkpoint. If no SVF code has been received this field is 
set to zero (0). If the SVF is inside a parameterized string* the counter 
points to the control code of the parameters (for example* the immediately 
preceding SCB control code.) 

• V-off set 

V-offset is a 2-byte binary counter that indicates the position within an SCB 
string or structured field of the SVF code. It points to the 
uncompacted/uncompressed position of the SVF. 

This field is set to zero (0) if the vertical field points to the actual SVF 
code. 

• Horizontal (Horizon.) 

The horizontal field is a 4-byte binary counter that indicates the byte 
offset from the Set Checkpoint Interval structured field to the SHF code 
point in effect for this checkpoint. If no SHF has been received* this field 
is set to zero (0). If the SHF is inside a parameterized string* the counter 
points to the control code of the parameter (for example* the immediately 
preceding SCB control code). 

• H-offset 

H-offset is a 2-byte binary counter that indicates the position within an SCB 
string or structured field of the SHF code. It points to the 
uncompacted/uncompressed position of the SHF. 

This field is set to zero (0) if the Horizontal Field points to the actual SHF 
code. 
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• Flags 

Bit of the flag field indicates whether or not the printer requires the SVF 
format to be present in the Restart structured field. If bit is one (1), 
the primary must use the vertical field and V-offset to locate the SVF format 
and resend it in the Restart structured field chain. If bit is zero (0)> 
the primary does not have to send the SVF format as the printer can assure 
that the formats are still set properly. 

Bit 1 of the flags field is the same as bit 0, but for SHF. 

• Set Line Density (SLD) 

This field is the 1-byte parameter field of the SLD in effect at the check- 
point. The default value (X'00*) is used if SLD is not supported or has not 
changed since the checkpoint. 

• C-seq 

This field contains the RU sequence number of the RU containing the check- 
pointed character. 

• C-seq-offset (C-seqoff) 

This field contains the byte offset within the RU of the checkpointed charac- 
ter. 

• V-sequence (V-seq'ce) 

This field contains the RU sequence number of the RU that contains the SVF 
control code in effect at the checkpoint. 

• H-sequence (H-seq'ce) 

This field contains the RU sequence number of the RU that contains the SVF 
control code in effect at the checkpoint. 

• V-length 

This field contains the length of the SVF parameter string that must be 
returned in the Restart structured field. It includes the SVF control code 
and all parameters following. 

• H-length 

This field contains the length of the SHF parameter string that must be 
returned in the Restart structured field. It includes the SHF control code 
and all parameters following. 

• Set Print Density (SPD) 

This field is the 2-byte parameter field of the SPD in effect at the check- 
point. The default value (X*0000*) is used if SPD is not supported or has not 
changed since the checkpoint. 

• Color 

This field is the 1-byte parameter field of the SA (set attribute) value for 
color in effect at the checkpoint. The default value (X'00*) is used if SA 
for color is not supported or has not changed since the checkpoint. 

• Character Set (Char. Set) 

This field is the 1-byte parameter field of the SA (set attribute) value for 
character set in effect at the checkpoint. The default value (X'OO*) is used 
if SA for character set is not supported or has not changed since the check- 
point. 

• Hilite 

This field i s the 1-byte parameter field of the SA value for highlighting in 
effect at the checkpoint. The default value (X'00') is used if SA for high- 
lighting is not supported or has not changed since the checkpoint. 
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REQUEST RECOVERY DATA 



RESTART 



FUNCTION 

Sent from PLU to SLU to request recovery data for Print Job Restart 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2-3 




XU030' 


Request Recovery Data 


4 






Reserved 



OPERATION 

This structured field must flow to enable the SLU to send the recovery data to 
the PLU. 



FUNCTION 

Sent from PLU to SLU to indicate that the restart is in progress and that a 
certain number of pages and lines should be bypassed before printing starts 
again using the data that follows. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2-3 




X f 1033» 


Restart 


4 






Reserved 


5-6 




Start Pg 


Number of pages to skip on restart 


7-8 




Start Ln 


Number of lines to skip on page for restart 


9-n 




SCS Data 


SCS data (noncompressed and noncompacted) to set 
up for restart 



OPERATION 

The SCS data field must include the required SHF and/or SVF and other SCS data 
for restart. The first byte of FM data resumes at the checkpoint spot or at 
the start of the SCB string or structured field containing the checkpoint 
spot in the following RU chain. 

• Start Page (Start Pg) 

The start page is the indication sent by the PLU to the SLU of the number of 
pages that are to be bypassed prior to printing during a restart operation. 
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SCS DATA 



• Start Line (Start Ln) 

The start line is the indication sent by the PLU to the SLU of the number of 
lines on the starting page that are to be bypassed prior to printing during a 
restart operation. 

• SCS Data 

SCS data is sent in the Restart structured field to reestablish various 
parameters to the state at the time of the checkpoint. For example, the SVF 
and SHF codes indicated by the vertical and horizontal offsets in the Recov- 
ery Data structured field. Any SCS codes (control or graphic) may be 
included. Counts are reset to those at the time of the checkpoint after proc- 
essing the SCS codes within the structured field. 



FUNCTION 

Allows SNA character string (SCS) controls and data to be intermixed with 
structured fields. 



FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of thi s structure 


2 




X^l' 


SCS Data 


3 




X'00' 


Reserved 


«-n 




Data 


SCS controls and data 



OPERATION 

The SCS data portion of this structured field is treated the same as SCS data 
not delimited by an SCS Data structured field. (For details on SCS controls, 
see Part 2 Chapter 1.) 



SET CHECKPOINT INTERVAL 



FUNCTION 



Passes from PLU to SLU the number of pages that are to be i n the interval 
between checkpoints. It contains the recovery data needed by the PLU to 
recover from the error. 

FORMAT 



BYTE 


BIT 


CONTENT 


MEANING 


0-1 




L 


Length of this structure 


2-3 




X f 1032* 


Set Checkpoint Interval 


4 






Reserved 


5-6 




Interval 


Checkpoint interval: Number of pages to be 
printed between checkpoints. A zero value indi- 
cates that checkpoints are not to be taken. 
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OPERATION 

Interval specifies the number of pages in the interval between SLU check- 
points. This number is set in the SLU by the PLU's use of the Set Checkpoint 
Interval structured field; it is a 2-byte value to enable checkpointing of 
jobs that use short forms without taking an excessive number of checkpoints. 

This structured field resets all previous checkpointed information. The 
checkpoint counters begin with the f i rst FM data byte following the struc- 
tured f i eld. 



SENSE CODE TABLE 





SNA SENSE CODES (HEX) 




1003 


1005 


0863 


OTHER 


STRUCTURED FIELDS (all struc. fids.) 










Invalid structured field type 


X 








Missing structured field parameter 




X 






Reserved field is not zero 


X 








LOAD PROGRAMMED SYMBOLS 










Incorrect length 




X 






Invalid data type 


X 








Invalid LCID (Values X^O* thru 










X'EF* are not considered invalid) 


X 








CHAR < X*41 f or > X*FE f 




X 






RWS not in range X'OZ'-X'O?' 








084C 


RWS is valid but not installed 








084C 


EXTN not supported 




X 






P — length incorrect 




X 






Byte 8> bits 3-7 not zero 


X 








Invalid LH or LW 




X 






Byte 12, bits 5-7 invalid 








084C 


Excess bits in data 




X 






Compressed data terminator 










incorrectly specified 




X 






PS resource not available 








084C 


READ PARTITION 










Incorrect length 




X 






Invalid read operation code 


X 








Read Partition not last structured 










field in chain 




X 






Chain containing Read Partition 










does not specify CD 








0829 


Chain containing Read Partition 










does specify EB 








0829 


SCS DATA 










Incorrect length 




X 
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PART 2 CHAPTER 4. FUNCTION MANAGEMENT HEADERS 



This chapter explains how function management headers (FMHs) are used to 
exchange information between session partners and how that information 
controls the activities performed by the LU (logical unit). It also defines 
the formats of the FM headers and shows how those FM headers are exchanged 
with the RU (request/response unit). 

This chapter need not be read by persons implementing LU-LU session types 2 
and 3. Those persons implementing LU-LU session types 1 and 4 should read the 
sections covering FMH-1 through FMH-3. Those persons implementing LU-LU 
session type 6 should read the sections covering FMH-4 through FMH-10. 

The RU is that part of the PIU (path information unit) that carries control 
information and end-user data between half-sessions. A control RU contains a 
request or an acknowledgment. A data RU may contain function management 
-h-ea-de^s— (-F- M H s ) , string c on tf"o 1 bytes— ( S C B s ) -> da^tay oraiiy-comb matron of the 
three. The data can be any data stream allowed by the LU-LU session type. 
Examples of RU formats are shown in Figure 4-1. 

Control Transmissions 



TH 


RH 


Request 



TH 


RH 



(Positive response to FM data RU) 



TH 


RH 


Data 



(Negative response) 



Data Transmissions 



TH 


RH 


FMH 



TH 


RH 


FMH 


Data 



TH 


RH 


FMH 


FMH 


Data 



TH 


RH 


FMH 


SCB 


Data 


SCB 


Data 



Figure 4-1. Examples of RU formats. The PIU i s composed of the TH (trans- 
mission header), RH (request/response header), and RU (request/response 
unit). Although the use is not exclusive, path control (PC) uses the TH, 
transmission control (TO and data flow control (DFC) use the RH, and session 
presentation services (SPS) and end users use the RU. The data formats are 
representative? not all formats are shown. 



TYPES OF FUNCTION MANAGEMENT HEADERS (FMH) 

Function management headers (FM headers or FMHs) enable an LU to send a data 
stream to a specific destination and control the way the data is presented at 
the destination. FM headers are the mechanism that one LU uses to select some 
of the functions it wants the presentation-servi ces components of its session 
partner to perform. 
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FM headers are used in LU-LU session types 1, 4, and 6; they are not used in 
the SSCP-LU session or by LU session types 2 and 3. 

The BIND request* s presentation services usage parameters indicate whether 
the LU is allowed to send FM headers in the RU. These parameters also define 
which optional FMH functions sre permitted in the LU-LU session. Since FMH 
functions differ between session types, you should review the "FM Header 
Processing" section and the BIND request descri pti on in the chapters that 
describe LU-LU session types 1, A, and 6. 

The request header (RH) contains a format indicator (FI) that, when on, indi- 
cates that an FMH is at the beginning of the RU. The format indicator is set 
on in the RH of the first RU in the chain. If more than one FM header is pres- 
ent in the RU, a concatenation flag is set on in each FMH that has another FMH 
following it. The rules that must be followed are described under "Rules for 
FMH-1, FMH-2, and FMH-3" below. 

The FM headers that can be used by LU-LU sessions are: 

FMH-1 ; FMH-1 is used to select a destination within an LU. A destination is 
the medium on which data is presented; it may be a device, a data set residing 
on a device, or a data stream. The medium select and destination name fields 
within the header identify the destination. The fields can be used alone or 
in combination as follows: 

• Medium select field (byte 2). Selects a medium (a device type and a partic- 
ular logical component) within the LU. The LU may or may not have a phys- 
ical component that matches the medium selected. The absence of a console, 
for example, does not preclude the sending of an FMH-1 selecting a console. 
In this case, the receiving LU may elect to direct the data to a printer or 
disk. The receiving LU is responsible for taking the appropriate action. 

Each medium has a default data stream. Unless you specify a different data 
stream in another field of the FMH-1, the medium select field defines the 
data stream to be used. (For allowable data streams, see "Function Manage- 

meiiv. iicauei type x \i tin xs ucavjin, viicii sets i ai v J. \iiiafvei s c aim ■/ iui 

limitations on their use.) 

• Destination name field (bytes 9-n). Selects a logical component (either 
alone or in combination with the medium select field), which implies a data 
stream. 

The physical device that is selected by the receiving LU is transparent to 
the session partner, but the session partner can influence the selection by 
using the demand select indicator in byte 3 of the FMH-1. For example, an LU 
may choose to use the indicator to prevent the session partner from spooling 
the data sent after the FMH-1. 

The FMH-1 is used to initiate and conclude data traffic to a destination. It 
is also used to interrupt previously started data traffic (for example, to 
send a message to the console operator) and to resume it at a later time. 
Also, it can be used to indicate that the characteristics of the data stream 
ere changing, but that the destination remains the same. Finally, the FMH-1 
identifies whether an 5CB follows. 

FMH-2; FMH-2 specifies the data management activities to be performed at the 
destination selected with the FMH-1. Typical data management activities are 
adding and replacing records, creating and deleting data sets, and providing 
status information. An FMH-2 may be concatenated to an FMH-1. When it is, 
the FMH concatenation (FMHC) field of the FMH-1 is set to one to indicate that 
another. FMH follows. 

FMH-3: FMH-3 carries information that relates to all destinations of both 
session partners. For example, a compaction table to compact and decompact 
data can be sent as an FMH-3 if the table pertains to all destinations within 
the session. 

FMH-4: FMH-4 carries information for a transaction program called logical 
message services. The FMH-4 tells the receiver what to do with a block of 
data within a message, as defined by logical message services. 
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FMH-5: FMH-5 identifies the transaction program that i s to be attached to the 
receiving half-session. For example* a transaction program at the sending 
half-session sends an FMH-5 to tell the receiving half-session the name of 
the transaction program it wants to talk to. 

FMH-6 : FMH-6 carries information that relates to work being done by the tran- 
saction programs at each end of the session. For example* a transaction 
program sends an FMH-6 to identify the queue on which it wants the subsequent 
data to be placed. 

FMH-7: FMH-7 carries information that relates to a previous error on the 
session. For example* an FMH-7 and error information are sent when a session 
partner detects certain error conditions. 

FMH-10: FMH-10 requests that the receiver prepare for a sync point. The 
receiving session partner* on the next flow, either requests a sync point or 
aborts the unit of work. 

The next section in this chapter discusses the rules for using FM headers. 
You should use Figure 4-2 to decide which of the FMH descriptions you need to 
read for the LU-LU session type you are using. 

Types of FM 
LU-LU session type headers allowed 






User defined 


1 


1* 2, 3 


2 


None 


3 


None 


4 


1* 2, 3 


6 


4, 5, 6, 7, 10 



Figure 4-2. FM headers allowed by LU-LU session type 



FM HEADERS FOR LU-LU SESSION TYPES 1 AND 4 



USING FMH-1 FOR DESTINATION SELECTION 

Function management header type 1 (FMH-1) has seven functions that can be 
used by an LU to control the direction of data movement with another LU. 
These functions are: 

BEGIN Selects a destination (called the "active" destination) at the 
receiving partner to which the sending partner will send data 

SUSPEND Interrupts* or suspends temporarily* data traffic to the active 
destination 

RESUME Causes the destination that was last suspended to again become the 
active destination 

END Ends data traffic to the active destination 

BEGIN/END Selects a destination* transmits data, and ends traffic in one 
operation 

END-ABORT Abnormally ends data traffic to the active destination 

CONTINUE Retains the active destination* but changes FMH-1 parameters 
describing the data to be transmitted 
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A default destination is assumed when FM headers are used by the session and 
data is sent or received wi thout an FMH-1 (with no specific destination 
active). The default destination and data format are: 

Medium = Console 

Logical subaddress =0 

No destination name (DSNAME) 

No compression 

No compaction 

The process of managing which destination is active is done by the session 
partners maintain! ng stacks* or push-down queues. A stack entry contains all 
the device control information needed to manage the device, or it points to 
that information. 

A pair of stacks may be viewed as containing the destinations begun by one LU 
and received by the other. If LU A selects destination 1, then suspends it 
and selects destination 2, the stacks will appear: 



LU A Send Stack 



LU B Receive Stack 



FMH-1 for 
destination 2 



FMH-1 for 
destination 1 



FMH-1 for 
destination 2 



FMH-1 for 
destination 1 



A second pair of stacks contains the destination(s) begun by the session 
partner (LU B). When LU B begins a destination, the stacks contain: 

LU A Send Stack LU A Rev. Stack LU B Rev. Stack LU B Send Stack 



FMH-1 for 
destination 2 



FMH-1 for 
destination 1 



FMH-1 for 
destination 3 



FMH-1 for 
destination 2 



FMH-1 for 
destination 1 



FMH-1 for 
destination 3 



The active destinations appear at the top of the stacks — one active desti- 
nation for each direction. All other entries in the stacks are called 
suspended destinations. 

A parameter in BIND defines the depth of the stacks; that is, how many FMH-ls 
the stack can hold. If a one-level stack is selected, there can be one desti- 
nation selected. The destinati on cannot be suspended; it must be ended 
before another destination is begun in that direction. 

If a two-level stack is selected, the active destination can be suspended, 
and data sent to a second destination (as shown above). Suspending a print 
job and sending a message to an operator is an example of how a two-level 
stack can be used. 

If a three-level stack is selected, two destinations can be suspended and 
data sent to a third destination. 

Each half-session controls its own send stack and, through the FMH-ls it 
sends, its active destination. Either half-session can terminate session 
traffic abnormally. By using the stack reference indicator (SRI) in the 
FMH-1, an LU can identify either half-sessi on* s send stack and send an 
END-ABORT FMH-1 against the active desti nation in that stack. By using the 
end bracket indicator (EBI) in the RH, an LU can reset all stacks for the 
half-session. 

The following destinati on selection operations are defined: 

• The sender and receiver of a BEGIN write an entry in the first element of a 
stack. All other entries in the stack remain unchanged. 
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• The receiver of BEGIN activates all information contained in the FMH-1 and 
FMH-2 except: 

Length of header 
Concatenated or not 
Type of header 

• The receiver of BEGIN/END writes an entry in the first element of a stack, 
activates all information contained in the FMH-1 and FMH-2, and after proc- 
essing any data, erases all information. 

• The sender and receiver of SUSPEND push down all entries in a stack by one 
element. The first element becomes empty; that is, it has no entry. The 
destination previously active becomes the second element. 

• The receiver of SUSPEND saves all information that was activated by the 
previous BEGIN. 

• The sender and receiver of RESUME pop up all entries in a stack by one 
element. The second entry, previously suspended, becomes active. The last 
entry in the stack, if present, is moved up one element, and the last 
element of the stack becomes empty. 

• The receiver of RESUME restores all information that was saved from the 
previous SUSPEND. 

• The receiver of END or END-ABORT erases all active information in the top 
entry of the stack. 

• The sending or receiving of a CONTINUE has no effect on the stack. 

• The receiver of CONTINUE overlays the information contained in the CMI, 
CPI, and ERCL fields of the FMH-1. (These fields are for compression, 
compaction, and exchange record length, respectively.) All other informa- 
tion remains active from the previous BEGIN. 

• A stack is reset when all its elements are empty. In addition, the stacks 
are reset whenever the half-session enters in-brackets state. The stacks 
also are reset by ACTPU, DACTPU, ACTLU, DACTLU, BIND, SDT, CLEAR, and 
UNBIND. 

The rules to be used for these operations are defined under "Rules for FMH-1, 
FMH-2, and FMH-3" on page 191. 

USING FMH-2 FOR DATA MANAGEMENT 

Frequently, an LU needs to be able to access data located at its session part- 
ner. Function management headers type 2 (FMH-2s) enable an LU to perform 
these data management operations. The FMH-2 is the way one LU tells another 
LU what it wants done at the active destination it specified in a previous 
FMH-1. 

A variety of data set organizations are permitted: 

• Sequential. Sequential access to all records 

• Addressed direct. Relative data set using a record number for retrieval 

• Keyed direct. Relative data set using a key for retrieval 

• Keyed indexed. Indexed data set using a key for retrieval 

An LU uses FMH~2s to create and modify these data sets. Changes can be 
performed on a record or a group of records. In addition, several FMH-2s 
allow the LU to send and receive status information about the data set. 

In some cases, more than one FMH-2 Can be used to perform an operation. One 
header can define the operation to be performed, while another tells where to 
perform it or provides a password. The FMH-2 that defines the operation is 
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the root FMH-2. The ones that identify where the operation i s to be performed 
or provide the password are the extension FMH-2s. 



Root and extension headers are shown in Figure 4-3. 



Operation Type 



FMH-1 



Root FMH-2 



Extension FMH-2 



Destination selection 

Volume selection 
Data set 

Record 



Compression and 
compacti on 

Operation information 
Status 

Scheduling 

Record identification 



Begin 
Begi n/end 
Resume 

Begin 
Begin/end 

(Note) 



(Note) 

(Note) 
(Note) 
(Note) 

(Note) 
(Note) 



Create data set 
Scratch data set 
Scratch all data sets 
Erase data set records 

Add 

Add replicate 

Replace 

Replace replicate 

Erase 

Compaction table 

Prime compression character 

Peripheral data information 
record 

Query for a data set 

Note 

Note reply 

Execute program offline 



Volume ID, Password 
Volume ID, Password 

Password 
Password 
Password 
Password 

Record ID, Password 
Password 
Record ID, Password 
Record ID, Password 
Record ID, Password 



Password 



Record ID, Password 



Note: A destination must be active, that is, a BEGIN, BEGIN/END, CONTINUE, or 
RESUME FMH-1 must have been the last FMH-1 issued. If no destination is active, the 
transmission goes to the console. 

Figure 4-3. FMH-1 and FMH-2 relationship. Data management is accomplished using 
function management headers (FMHs). An FMH-1 is used to select a destination, then 
FMH-2s are used to process data at that destination. 

In summary, this section has defined how an LU is able to access data in 
specific data sets using FMH-1 and FMH-2. As such, the LU sends and receives 
information from a single destination — the active destination. 

There is some information, however, that applies to all destinations in the 
session. To send and receive this common information, an LU uses function 
management headers type 3 (FMH~3s). 



USING FMH-3 FOR DATA MANAGEMENT 

Function management headers type 3 (FMH-3s) carry information that pertains 
to all destinations of the session. The FMH-3 format is identical to the 
FMH-2 format except that the FMH-3 does not have a stack reference indicator, 
having no need to identify a specific destination. 

An FMH-3 cannot be concatenated to other headers; it must be sent as the first 
header in a chain. Some FMH-3s permit headers to follow. (See "FMH-3 Concat- 
enation and Chaining Rules" on page 195.) 

FMH-3 functions are shown in Figure 4-4 and defined under "Function Manage- 
ment Header Type-3 (FMH-3)" on page 227. 
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Type of Operation FMH-3 Function 

Compression and Query for a compaction table 
compact! on 

Send a compaction table 

Send a prime compression character 

FMH correlation Send a series ID 

Send status 

Figure 4-4. FMH-3 functions. FMH-3 is used to process information for all 
destinations in the LU-LU session. 



RULES FOR FMH-1, FMH-2, AND FMH-3 

Hierarchy Rules 

Hierarchy rules describe how and when headers are used. The following rules 
specify and define FMH-1, FMH-2, and FMH-3 interactions: 

1. An FMH-1 must be used to select a destination except for the default 
destination (use the BEGIN, BEGIN/END, or RESUME form of FMH-1). A 
destination, once selected, becomes the active destination. 

2. An FMH-1 must be used to indicate completion of the selected destination 
(use SUSPEND or END). 

3. All FMH-25 apply to the active destination. 

4. An FMH-2 may occur only when a destination is active and may occur: 

Immediately following an FMH-1 or another FMH-2 
As the first FM header in an RU chain 

5. An extension FMH-2 applies to the last root FMH-2 sent for the active 
desti nati on. 

6. An FMH-3 applies to all destinations in the LU-LU session. 

7. An FMH-3 may be sent at any time; a destination need not be active. 

FMH-1 Destination Selection Rules 

Rules for selecting destinations are listed below and summarized in Figures 
4-5 and 4-6. 

1. A BEGIN, BEGIN/END, or RESUME is valid only when the first element of a 
stack is empty. An error response must be returned if the first element 
is not empty. (See Figure 4-5.) 

2. An END, END-ABORT, CONTINUE, or SUSPEND is valid only when an entry is in 
the first element of a stack. That is, a destination must be active to 
suspend or end (normal or abort) it. An error response may be returned if 
the first element is empty. (See Figure 4-5.) 

3. BEGIN, SUSPEND, RESUME, CONTINUE, and END must be sent with the stack 
reference indicator (SRI) set to zero; only END-ABORT and, for reply-type 
structured fields only, BEGIN/END may be sent with the SRI set to one. 
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6. 



7. 



The receiver of a BEGIN retains all the information contained in the 
FMH-1 except FMHC and SRI information. The receiver also is required to 
retain related, static FMH-2 information. The sender of BEGIN is not 
required to resend this information on a subsequent SUSPEND, RESUME, END, 
CONTINUE, or END-ABORT. 

Since a stack entry contains all the destination selection parameters 
contained in the FMH-1 as well as related, static information contained 
in subsequent FMH-2s (such as VOLUME ID), the receiver of a SUSPEND, 
RESUME, END, or END-ABORT performs the appropriate destination selection 
operation. No other parameters in these FMH-ls are examined. 

After a destination has been selected using BEGIN, the destination 
remains active, and all FM data is sent to the active destination until 
another FMH-1 is sent to change the active destination. 

The use of SUSPEND requires the use of RESUME to continue directing data 
to the suspended destination. 



Input 


Stack Condition 


BEGIN 


PI = Empty 
PI -= Empty 


END or 
END-ABORT 


PI = Empty 
PI -= Empty 


SUSPEND 


PI = Empty 
PI -»= Empty 


RESUME 


PI = Empty 
PI -= Empty 


CONTINUE 


PI = Empty 



PI -= Empty 

BEGIN/END PI = Empty 
PI -= Empty 



Output 

Write to stack 

Error (mandatory -RSP XUOOSZQQl") 

Error (-RSP X , 10082002») 
Erase active destination entry 

Error (-RSP X» 10082002* ) 
Push down stack 

Pop up stack 

Error (mandatory -RSP X , 10082001 t ) 

Error (-RSP X f 10082002 f ) 

Use active destination with any 

altered CMI, CPI, or ERCL 

Write to stack and erase active 
destination at completion of operation 
Error (mandatory -RSP X'lOOSZOOl' ) 



Figure 4-5. Summary of destination selection operations, 
entry in the stack. 



PI i s the top 



192 SNA — Sessions between Logical Units 



SEQUENCE 1: 
Send stack 



Empty* A 



—BEGIN A > 

-SUSPEND A— -> 
No FMH* data-> 



Receive stack 

A 
Empty* A 

(Data without an FMH-1 
is sent to default 
destinati on) 



SEQUENCE 2: 

LU X 

Send stack 



JLU I 
Recei ve stack 



Empty* A 

B,A 

Empty* A 

A 



•—BEGIN A > 

-SUSPEND A— > 

—BEGIN B > 

END B > 

-RESUME A > 

■No FMH* data-> 



Empty, A (Note 1) 

B*A 
Empty, A 

A (Note 2) 
(Data without an FMH-1 
is sent to destination A) 



Figure 4-6 (Part 1 of 2). Sample stack sequences. 
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SEQUENCE 3i 



Send stack R 
A 

A 



cv stack 




Rev stack 


Y 
Send stack 


Reset 
B 
B 


—BEGIN A— > 
-data > 

(Note 3) 
<— BEGIN B— 
< data 

(Note 4) 
data 


A 
A 
A 




Reset 

B 
B 




(Note 5) 





SEQUENCE 4; 

LU X 
Send stack Rev stack 



Empty* A 



Reset 



LU Y 
Rev stack Send stack 



A 


Reset 




A 


Reset 


<— 

( 


A 


Reset 





A 


Reset 





A 


Reset 


<-- 

( 



BEGIN A— > A 

- +RSP — A 

Note 6) 

-data > A 

-data > A 

- -RSP A 

Note 7) 

SUSPEND > Empty, 

-data > 

Notes 8,9) 



Reset 
Reset 

Reset 
Reset 
Reset 

Reset 



noxes: 

1. The use of SUSPEND requires the use of RESUME to continue directing data 
to destination A. 

2. If RESUME A were not sent, the data following END B would be directed to 
the default destination. 

3. Data directed to destination A. (A stack is reset when all stack 
elements are empty.) 

4. Data directed to destination B. 

5. Data directed to destination A. 

6. A positive response is returned to a BEGIN FMH-1 sent OIC. 

7. Negative response does not put the default destination in LU X send stack 
or LU Y receive stack. 

8. Data directed to default destination. 

9. If SUSPEND were omitted from this sequence, the data following the nega- 
tive response would be directed to destination A. 

Figure 4-6 (Part 2 of 2). Sample stack sequences. 



FMH-1 concatenation and Chaining Rules 

1. An FMH-1 cannot be concatenated to another FMH-1. 

2. An FMH-2 cannot be concatenated to an FMH-1 indicating SUSPEND, CONTINUE, 
END, or END-ABORT. 

3. An FMH-2 can be concatenated to an FMH-1 indicating BEGIN, BEGIN/END, or 
RESUME. 
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e t. An FMH-3 cannot be concatenated to an FMH-1. 
5. An FMH-1 must be contained within a chain. 



FHH-1 Data Rules 



1. An FMH-1 indicating SUSPEND, CONTINUE, or END-ABORT must be sent without 
FM data. 

2. An FMH-1 indicating BEGIN, BEGIN/END, RESUME, or END may be sent with or 
without data. 

3. An EB resets the send and receive stacks for both directions. 

4. CLEAR and SDT reset the send and receive stacks in both directions. 



FMH-2 Concatenation and Chaining Rules 

1. A root FMH-2 may be sent alone, or it may be concatenated to an FMH-1. 

2. A root FMH-2 cannot be concatenated to an FMH-1 indicating SUSPEND, END, 
or END-ABORT. 

3. Only one root FMH-2 is allowed per chain. 

4. Extension FMH-2s follow these rules: 

a. A VOLUME-ID FMH-2, when sent, must be concatenated to an FMH-1. 

b. A RECORD-ID FMH-2 may be sent alone in a chain, or it may be concat- 
enated to a root FMH-2. 

c. A PASSWORD FMH-2, when sent, must be concatenated to an FMH-1, a root 
FMH-2, or an extension FMH-2. 

d. More than one extension FMH-2 is permitted per chain, but there can 
be only one of each kind per chain. 

5. An FMH-2 must be contained within a chain. 



FMH-2 Data Rules 

1. FM data may follow an FMH-2 or be sent as the next chain. 

2. If no root FMH-2 is concatenated to an FMH-1 with FM data, sequential 
addition of records (the ADD FMH-2) is the default. 



FMH-3 Concatenation and Chaining Rules 

1. An FMH-3 must be sent first in a chain. 

2. The SERIES-ID FMH-3 and the STATUS FMH-3 permit an FMH-1 or FMH-2 to be 
concatenated to them. 

3. An FMH-3 must be contained within a chain. 
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SENSE CODES FOR FMH-1, FMH-2, AND FMH-3 ERRORS 

The logical errors concerned with the hierarchy, format, and protocol of FM 
headers are reflected in user sense codes appended to the system sense code 
X'1008* (invalid FM header). FM header session errors and data processing 
errors also follow this approach. If this level of error detection is not 
provided, then the sense code X* 10080000* is returned. 

In addition to FM header errors (sense codes X'lOOSOOOO* or X* lOOSxxxx* ) , 
other request error as well as request reject errors, transmission control 
errors, and path control errors may be sent or received to an RU chain 
containing only FM header(s) or FM header(s) and end user data. 

Session Errors (100840xx) 

Invalid FMH type (4001) 

Invalid FMH code (4002) 

Compression not supported (4003) 

Compaction not supported (4004) 

Basic exchange not supported (4005) 

Only basic exchange supported (4006) 

Medium not supported (4007) 

Code selection compression violation (4008) 

FMHC not supported (4009) 

Demand select not supported (400A) 

DSNAME not supported (400B) 

Invalid medium subaddress field (400C) 

Insufficient resources to perform FMH function (400D) 

DSP select not supported (400E) 

FM Header Protocol Errors (100820xx) 

Invalid destination — active (2001) 

Invalid destination — inactive (2002) 

Invalid destination — suspended (2003) 

Invalid suspend-resume sequence (2004) 

Interruption level violation (2005) 

Invalid resume properties (2006) 

Destination (MEDIUM. SUBADDRESS. DSNAME) not available (2007) 

Invalid end sequence (2008) 

Invalid FM header length (2009) 

Invalid field setting — reserved field set to one or setting not 

defined (200A) 
Invalid destination — destination does not exist (200B) 
Invalid ERCL (200C) 
Invalid DST (200D) 

Invalid concatenation — header can not be concatenated (200E) 
FM data not allowed for header (200F) 
Bind FM header set violation (2010) 
FM header not sent concatenated (2014) 
Stack reference indicator invalidly set to one for BEGIN, SUSPEND, 

RESUME, or END FMH-1 or for FMH-2 (2019). 
Unable to accept CMI modification (201A) 
Unable to accept CPI modification (201B) 
Unable to accept ERCL modification (201C) 

Data Processing Errors (100808xx) 

Invalid function code parameters (0801) 

Forms function cannot be performed (0803) 

Unable to perform copy function (0805) 

Compaction table outside supported subset (0806) 

Invalid PDIR identifier (0807) 

Printer train function cannot be performed (0808) 

FCB Load function cannot be performed (0809) 

FCB load function not supported (080A) 

Invalid compaction table name (080B) 

Invalid ACCESS (080C) 

Invalid RECLEN (080D) 
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Invalid NUMRECS (080E) 

Data set in use (080F) 

Data set not found (0810) 

Invalid password (0811) 

Function not allowed for destination (0812) 

Record too long (0813) 

Data set full (0814) 

Invalid RECID (0815) 

Invalid VOLID format (0817) 

Number of logical records per chain exceeded (0818) 

Data set exists (0819) 

No space available (081A) 

Invalid VOLID (081B) 

Invalid DSACCESS (081C) 

Invalid RECTYPE (081D) 

Insufficient resolution space (081E) 

Invalid key technique (081F) 

Invalid key displacement (0820) 

Invalid key (0821) 

Invalid N (number of records) (0822) 

Invalid KEYIND (0823) 

Invalid SERID (0824) 

Invalid RECID format (0826) 

Password not supplied (0827) 

Record ID not supplied (0828) 

Volume ID not supplied (0829) 

Invalid PGMNAME (082A) 

Note: The capitalized words above are parameters within an FMH-1> FMH-2, or 
FMH-3. (See the header formats later in this chapter for parameter defi- 
ni ti ons. ) 
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USING FMH-* FOR DESCRIBING DATA 

FMH-4 may be used by one session partner to describe the data it is sending to 
the other session partner. The data is handled on each end of the session by 
transaction programs. The transaction program that uses FMH-4s is called 
logical message services (LMS). 

The message manager within LMS is responsible for adding messages (received 
from the session partner's LMS) to the appropriate queue. It is also respon- 
sible for dequeuing messages requested by other programs at its end of the 
session and passing the messages to them for processing. 

Each message LMS receives from the session partner is preceded by an FMH-4. 

Transmission Types 

The transmission type is specified by a 2-byte field in a header. The first 
byte indicates the data stream type, and the second byte provides any quali- 
fying information. The data stream types are: 

Type code used Denotes 
X'0000'-X'3F00 f Reserved 

X'^ncc* Field formatted records. First byte indicates type 
of records (see explanations below)* and second 
byte identifies separator used between records. 

X'SOOO'-^EOO* Reserved 

X T FF00 f Type is specified only at a lower level. 
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Field Formatted Records (FFRs) 



The data portion of a field formatted record (FFR) comprises a sequence of 
transmission fields. The data content is not restricted in terms of 
contained byte-values. The essential property of an FFR is that it can be 
decomposed into separate fields by the receiving message manager based on a 
combination of information contained in the (explicit or implicit) headers 
and in the record data content. 

The following description assumes that the message manager obtains the 
following information when it does a read for an interchange unit: 

1. FMH = Yes/No 

2. DBA = ATTDBA (deblocking algorithm) 

3. Count of byte string 
$ . Byte string 

The FFR form seen by the message manager is: 

Byte Contents 

to n A logical record header. The header length is 
not explicit in the data stream. 

n+1 to m The data portion, called the logical record. 

Several FFR formats are defined. The purpose of these formats is to provide 
data stream conventions for indicating information about transmission-field 
to stored-logical-record-f i eld relationships. The information concerned 
covers: 

1. Whether an omitted transmission field is to replace a stored logical 
record field with a zero-length value or is to leave the stored logical 
record field unchanged 

2. To indicate the number of bytes in the transmission field value, and to 
control the length of the corresponding stored logical record field 

3. To indicate which stored logical record field a transmission field 
appli es to 

Three formats are defined: 

FFR-FNI X'40* Fixed fields without field separators 

FFR-FS X'41 f Fixed fields with field separators 

FFR-FS2 X*42 f Fixed fields with or without field separators 

FFR-FNI format. The FFR-FNI format relies on field ordering and a trans- 
mission field for every stored logical record field to indicate c) above; all 
remaining information must be communicated via embedded data conventions 
understood by the maps involved. 

The logical record comprises a sequence of transmission fields which are 
matched, in sequence, with fields in the corresponding stored logical record. 
A transmission field is a sequence of bytes with no leading or trailing sepa- 
rator. Any conventions concerning selector fields are receiver-map under- 
stood. 

FFR-FS format. The FFR-FS format also relies on field ordering and a trans- 
mission field for every field to indicate c) above. Further, a predefined 
separator character indicates unchanged fields of a) above, and indicates the 
number of bytes in the transmission field. 

The logical record comprises a sequence of fields which are matched, in 
sequence, with fields in the corresponding stored logical record. 

A transmission field is terminated by the first occurrence of a 
transmission-defined separator character. The separator character is 
defined following the X*41* FFR-FS code in the transmission type portion of 
the FMH-4. 
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If there are no data bytes preceding the separator of a transmission field, 
the transmission field has no effect on the corresponding stored logical 
record field. Otherwise, the bytes preceding the separator are applied to 
the stored logical record field using map-specified rules. 

FFR-FS2 format. The FFR-FS2 format is similar to the FFR-FS format, but is 
characterized by the use of a predefined separator character or the use of a 
predefined receiver map to determine field length. 

Fields are terminated by either the separator character defined in the byte 
after the X'42* FFR-FS2 code of the FMH-4, or the maximum length of the field 
as defined in the receiver map. 

command Execution Rules for FMH-3 

Command rules are: 

1. Make a stored logical block of the specified attributes the new last 
element in the current logical message. 

2. If the block is elementary, make the data portion of the current trans- 
mission block the value of the new block. 

3. If the block is compound, construct the block value by constructing its 
component stored logical records. 

Message service Errors 

The following sense codes are defined. They constitute negative responses 
for sender ERP and may be associated with message text flowing with FMH-7 for 
selective receiver ERP. 

Sense Code Error 

1008 C000 Header not supported 

1008 C001 Invalid header length 

1008 C002 Logical message services block-level error 

1008 C003 Version ID mismatch 



USING FMH-5 FOR ATTACHING TRANSACTION PROGRAMS 

FMH-5 FUNCTIONS: Function management header type 5 (FMH-5) has three func- 
tions that can be used by one half-session to control the attachment of tran- 
saction programs at the session partner on an LU_T6 session: 

• The ATTACH FMH-5 is used to tell the session partner to attach a specific 
transaction program, called the destination program. The ATTACH FMH-5 
contains the following information: 

Data stream profile (DSP) 
Deblocking algorithm (DBA) 
Destination program name (DPN) 
Return destination program name (RDPN) 
Primary resource name (PRN) 
Return primary resource name (RPRN) 
Destination process queue name (DQN) 
Access code 

• The DATA DESCRIPTOR FMH-5 is used to tell the session partner of a change in 
the characteristics of the data stream, such as a new data stream profile 
or deblocking algorithm. 

• The RAP FMH-5 (reset attached program FMH-5) is used to tell the session 
partner to detach the specified transaction program. 
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DATA STREAM PROFILE (DSP): The DSP field defines the type of data stream that 
i s to be sent. The field also permits an implementati on-defined modifier. 

DEBLOCKING ALGORITHM (DBA): The ATTDBA field of the FMH-5 identifies the 
algorithm used to create the quantity of data seen by a transaction program 
in a single read operation from its half-session. The defined deblocking 
algorithms are: 

A chain of RUs 
Variable-length records 

An RU is composed of the FM data following the RH. 

A chain of RUs can be composed of any generalized FM data, as delimited by end 
of chai n (EC) . 

Variable-length records can be composed of any binary data, delimited by a 
self-defining length. Records are of the form: 



length 


data 



The length field is 2 bytes. The length specified includes the length field. 

For output purposes, similar algorithms can be selected for the placement of 
application data into RU(s) and chain(s), for example: 

Application data equals chain 
Variable-length records 

A default DBA selection may be specified for both input and output. The iden- 
tification of the default deblocking algorithms is receiver defined. DBA is 
explicitly or implicitly (default) required for each message within an LIMT6 
sessi on. 

DESTINATION PROGRAM NAMES (DPN): Destination program names provide a mech- 
anism for selecting transaction programs within a transaction processing 
system (TPS). In the absence of an explicit program name, which is identi- 
fied in the ATTDPN field of the FMH-5, a default program can be selected. 

As programs run synchronously within the half-session, errors associated with 
the program can be reported if necessary via responses. A program in a queued 
system might be either the map procedure, that is, an interpretive program as 
in IMS, or perhaps a TPROCESS Queue in TCAM. For programs that execute within 
the half-session, a synchronous transaction code is appropriate for the 
program name. Reasonable defaults might be, respectively: 

The normal edit procedure and context router 

A customei — defined TCAM application 

The existing transaction decode algorithm 

NAMING TRANSACTION PROGRAMS: Transaction program names can be comprised of 
any combination of graphic characters. Implementation- and usei — defined 
program names must have a first character that is a graphic (X*40* to X'FE*). 
All IBM service program names have a first character that is a nongraphic 
(less than or equal to X*3F'). The assigned leading character for these 
service programs is: 

IBM service program Value 

System message program 
Scheduler program 
Queue program 
DL/1 program 

RETURN DESTINATION PROGRAM NAME (RDPN): The sending half-session may identify 
one program to receive a reply from the destination program in the session 
partner. The reply (or replies) occurs when the destination program 
completes the original request(s) of the sending program. The name of the 
program that is to receive the reply is sent to the destination program in the 
ATTRDPN field of the FMH-5. 
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X' 


01' 


X' 


02* 


X' 


03' 


X' 


05 f 



The RDPN may be used to support a pseudo-conversation between two TPSs over a 
period of time. One TPS sends a message to the other* providing the RDPN in 
the FHM-5 that will handle the reply. The second TPS processes the request* 
possibly generating collateral processing* and* by using the RDPN* sends its 
reply to the originating program. 

The receiving (destination) TPS need not use the RDPN. 

If an RDPN i s not received* a TPS may send a reply to the originating program* 
or it may select another program in the originating TPS and send the reply to 
that program. 

If a return program name is not received, no default is provided by the 
receiver, and the ultimate application is responsible for the creation of a 
program name to be used with the reply if one i s to be generated. 

PRIMARY RESOURCE NAME (PRN): In order to select and initiate a program in a 
TPS, it may be necessary to acquire a number of system resources required by 
that program for successful initiation. The required resources are normally 
specified by the requesting system, and must be validated by the receiving 
system before accepting (responding) to the request. Since these resources 
are to be acquired by the receiving system* they must be carried with the 
program initiation request. 



Typically within a TPS* a named program is associated with another resource 
or group of resources, such as the attaching terminal or a database. With 
LU_T6, it is possible to extend the resources associated with a named program 
to include a resource in the other half-session as well as a terminal. It is 
possible to send a request for program initiation on an LU_T6 session and to 
specify that the program i s to be attached only on the acquisition of named 



resources at the receiver, 
field in the ATTACH FMH-5. 



The named resources are specified in the ATTPRN 



The ATTPRN field may not be present if the program name does not require 
resources in order to be successfully attached. 

RETURN PRIMARY RESOURCE NAME (RPRN): Because a primary resource can be nomi 
nated when initiating a program, a return primary resource name can be asso- 
ciated with the return program. As with the return program name, this RPRN 
would be routed back with the reply (if generated) to the first system. 
Application override is possible as with return program name. 

The combination of the above four fields (ATTDPN, ATTPRN, ATTRDPN, and 
ATTRPRN) allows message routing facilities between the two sets of primary 
resource names as illustrated below: 



APPL 



APPL 



Al 



A2 



System 
A 



Tl T2 




Bl 



B2 



T3 




T4 



A message originating at terminal Tl on system A is directed to application 
Bl on system B for eventual return to terminal Tl via program Al. 
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System A System B 

(1) ATTACH (2) ATTACH 
DPN=B1 DPN=A1 
PRN= PRN=T1 
RDPN=A1 RDPN= 
RPRN=T1 RPRN= 

A message originating at terminal T4 in system B is directed to application 
A2 in system A for return to terminal T4 via application B2. 

System A System B 

(2) ATTACH (1) ATTACH 
DPN=B2 DPN=A2 
PRN=T4 PRN= 
RDPN= RDPN=B2 
RPRN= RPRN=T4 

A conversation can be achieved by always supplying a RDPN in both ATTACH 

FMH-5s. 

SCOPE OF PRN AND RPRN: The PRN is unique within the PRN name space of the 
receiving LU. The PRN and RPRN are composed of characters from the graphic 
set (greater than X'^O'). 

DPN QUEUE NAME (DQN): The ATTDQN field of the FMH-5 identifies a queue to be 
associated with a destination program name. This queue allows a sending 
system to build up a queue of data and to nominate a program in a receiving 
system to process it. 

INTERCHANGE UNIT TYPE (IUT): The source half-session specifies the limits of 
an interchange unit of data. The interchange unit may be contained within a 
single RU chain, or it may span multiple RU chains. The source half-sessi on 
specifies the way the information unit is packaged in the FMH5IUT field of 
the FMH-5. 

INTERCHANGE UNIT END (IUE): The source half-session identifies the end of an 
interchange unit by setting the FMH5IUE field of the FMH-5 to B , l*. The 
FMH5IUE field must be used to terminate an information unit when: 

The IU spans multiple RU chains 

The IU doesn't span RU chains, but a previous IU is still active that did. 

FMH5IUE =B'l' indicates that the IU ended with the last character of data 
sent prior to the FMH-5. With the exception that the FMH-5 must be at the 
beginning of the first RU in the RU chain, the source half-session can speci- 
fy termination of the interchange unit (in the multiple-chain case) independ- 
ent of any RH indicators. 

USING FMH-6 FOR TRANSACTION PROGRAM PROCESSING 

FMH-6 may be used by LU_T6 half-sessions to carry a transaction program's 
commands, messages, and data to an active transaction program at the session 
partner. The FMH-6 format is defined by LU_T6, but the commands to be used 
and the format of the data are defined by the transaction programs that are 
attached to the LU_T6 half-sessions. Consequently, only the general format 
of FMH-6 is discussed in this book (see "Function Management Header Type 6" 
on page 235) . 

An FMH-6 typically flows after an FMH-5 because it must be sent to an active 
(attached) transaction program. It may be the first FMH on the session, 
however, if it is for the default destination. Another FMH may follow the 
FMH-6; transaction programs can also define FMH-6s where other FMHs cannot be 
concatenated. 

FMH-6 field definitions are described in the publications of products that 
implement LU-LU session type 6. For additional details, see those publica- 
tions. 
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USING FMH-7 FOR ERROR RECOVERY 



FMH-7 is sent from one session partner to the other to define the cause of an 
error and to provide corrective information. The corrective information is 
called an ERP message* which can be any information understood by the session 
partners. An ERP message may contain any of the FM level LU_T6 sense codes. 
The format of the RU that contains the FMH-7 and ERP message is: 

< RU > 



RH 


FMH-7 


ERP message 



The session partners should use the SSCP character set to ensure compatibili- 
ty of messages between transaction programs. This character set is described 
in Figure 4-7. 
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Character set used for ERP message text and for LU to SSCP commu- 



Typically, an ERP message is sent by the data receiver (the half-session in 
receive state). When sent by the data receiver, it must be preceded by nega- 
tive response X^S^*. The RU chain carrying the FMH-7 and ERP message must 
be sent as one of the following: 

-BB,-EB, CD 

-BB, EB,-CD 

BB, EB,-CD 
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An ERP message may be sent by a half-session that is in send state when the 
half-session detects an SUW abort condition. In this case, the ERP message 
is not preceded by negative response X* 0846 V, and it may only contain one of 
the abort unit of work sense codes. The FMH-7 associated with it does not 
carry a correlation sequence number; in this case the chain carrying the 
FMH-7 may optionally flow with CD. 

Since SUW abort in one half-session leads to a sympathetic abort in the other 
half-session, half-sessions can exchange ERP messages and thus full informa- 
tion concerning the respective backout actions. ERP message exchange can 
occur within the failing bracket when the first ERP message carries CD and 
not EB. The reply may be another ERP message, LUSTAT X'OOOS', or restart 
data. 

An ERP message is part of a single RU chain; the chain is the first and only 
FMD chain following negative response X f 0846*. When the negative response is 
sent. with QRI=0, it may bypass any chain previously sent. Consequently, the 
chain containing the ERP message must contain additional correlation informa- 
tion. This information is provided by FMH-7. 



USING FMH-10 TO SYNCHRONIZE UNITS OF WORK 

FMH-10 is used to tell the session partner to prepare its resources so that 
work being done by the transaction programs can be synchronised. If the 
session partner can guarantee that the resources can be committed (updated) 
when the sync point is received, it requests a sync point (called request 
commit). If it can't commit the resources, it returns an FMH-7. 

FMH-10 is used primarily by implementations that have resources that must be 
synchronized across more than one LU_T6 session. The transaction program is 
responsible for handling the synchronizing of sessions. 

This section describes protocols that are related to FMH— 10 on a single 
session. The sender of FMH-10 must send the FMH-10 as the first FM header of 
the RU chain, and the last RU in the chain must have the CDI set on. The 
FMH-10 can be sent requesting a definite or exception response. (With defi- 
nite response protocol, a positive response only indicates that the RU chain 
containing the FMH-10 was received properly.) 



The following examples show a successful and an unsuccessful sync point, 
examples assume RU chains were sent requesting exception responses. 

EXAMPLE 1; Successful sync point. 



The 



BB,BC, 



FMH-10, data 



data 



EC,DRl,ER,CD,data 



BC,EC,DR2,ER,CD,data 



BC, 



DR2,ER,CD,data 



At the end of this chain, prepare 
■> for a sync point. 



RQE1 (Request exception response, 
•> if error encountered). 

RQE2 (Request exception response, 
— if error encountered, plus request 

for sync point). 

Confirmation of sync point, and 
-> continuation of data flow. 



An alternative to the last flow is: 



BCECDR2, CD, data 



Confirmation of sync point, and 
-> continuation of data flow, but 



BCECDR2, CD, LUSTAT X'0006 T a reply is required (in this case, 
LUSTAT X T 0006 f may be used). 
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Regardless of whether an FMH-10 is used, the DR2 indicator in the RH requests 
a sync point. Valid replies for successful sync points are: 

• Positive response with DR2 indicator set on if definite response is 
required (not shown above) 

• LUSTAT X'OOOS* with DR2 indicator set on if definite response is required 

• Any reply (request or response), including one with data, that has the DR2 
indicator set on. 



EXAMPLE 2: Unsuccessful attempt to achieve sync point. 



BB,BC, data 



-> 



EC,DR1,ER, data RQE1 (Request exception response, 

> if error encountered). 

BC,EC,DR2,ER,CD,data RQE2 (Request exception response, 

> if error encountered, plus request 

for sync point). 
DR2,RT, -RSP X'0846* Response type (RT) indicator set on 

identifies a negative response to 

the request for a sync point. 

BC,EC,DR1,ER,CD,FMH-7,ERP msg. The receiver purges RU chains back 

to the last synchronizing event, 

sending status information in the 
ERP message. 



Part 2 Chapter 4. Function Management Headers 205 



FIELD AND BIT DEFINITIONS FOR FK HEADERS 

This section defines field and bit settings for function management headers 
(FMHs). FM headers can be used on LU-LU session types 0, 1, 4, and 6. (LU-LU 
session types 2 and 3 do not use FM headers.) 

The headers are organi zed by type (FMH-1, FMH-2, FMH-3, etc.) and then alpha- 
betically within type. 

The following headers are defined: 

FMH-1 - This header is used to select a destination within an LU. A desti- 
nation may be represented by a device, a data set residing on a device, or 
merely a data stream. The LU initiates, interrupts, resumes, and concludes 
data traffic for that destination using the FMH-1. 

FMH-2 - Once a destination has been selected using an FMH-1, this header is 
used to handle the data management tasks for that destination. 

FMH-3 - This header is used to handle data management tasks that are common 
to all destinations in the LU-LU session. 

FMH-4 - This header is used to carry a logical block command and associated 
information. A logical block is contained within a logical message as 
defined for logical message services. Logical message services uses LU-LU 
session type 6 to transmit messages between end users. 

FMH-5 - This header is used to select a named transaction program within 
the receiving LU. FMH-5 flows from the LU services manager for the sending 
half-session to the LU services manager for the receiving half-session. It 
can be followed by other FMHs (for example, FMH-6 and FMH-4), a logical 
record header (LRH), and FM data. It can optionally be sent with CD or EB. 

FMH-6 - This header is used to carry a command from a currently active tran- 
saction program attached to the sending half-session to a currently active 
transaction program attached to the receiving half-session. 

FMH-7 - This header is used to send further information about an error 
after a negative response (0846) has been received. 

FMH-10 - This header is used to prepare the session for a sync point. It 
may be sent with data. The RU chain must have CD set on so that the receiv- 
er may, on the next flow, may request the sync point or abort the unit of 
work. FMH-10 flows from the LU services manager for the sending 
half-session to the LU services manager for the receiving half-session. 
Any data accompanying the FMH-10 is passed to the transaction program 
before the sync point. 
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FUNCTION MANAGEMENT HEADER TYPE 1 (FMH-1) 




Bvte 


Mi 


Content 




Meaning 









Length 




Length of header including length 


byte 


1 





FMHC 




FMH concatenation. 

B f f No FMH follows this FMH-1 

B'l 1 Another FMH follows this FMH- 


-1 




1-7 


B'0000001 


» 


FMH-1 Identifier 




2 


0-3 


Medium 

Select 

X f 0' 

X'1 T 

X T 2* 

X^ 1 

X'4' 

X f 5 T 

X f 6' 




Desired medium for data: 

Console 

Exchange 

Card 

Document 

Nonexchange disk 

Extended document 

Extended card 








X»7' 




Data set name selects destination 


(see Note 3) 






X'8» 




WP media 1 








X f 9 ? 




WP media 2 








X'A f 




WP media 3 








X T B» 




Reserved 








X'C T 




WP media 4 

All other values reserved. 






4-7 






Logical subaddress 








X'0 T ...X' 


E» 


Specific device in medium class 








X T F» 




Any device in medium class 




Note 1: 


The DSP 


defaults 


for 


the medium select field are: 





FMH-1 MEDIUM SELECT 



DEFAULT DSP 



Console, X'O* 
Exchange, X'l 1 
Card, X f 2 f 
Document, X*3 f 
Nonexchange disk, X*4* 
Extended document, X'5' 
Extended card, X f 6' 
WP medium 1, X'8' 
WP medium 2, X'9 f 
WP medium 3, X'A' 
WP medium 4, X'C* 



Base 

DST field of FMH-1 

SCS (IRS, TRN) 

Subset 2 (RJE) 

DST field of FMH-1 

Subset 2 (RJE) 

SCS (IRS, TRN) 

WP raw form 

WP raw form 

WP raw form 

WP raw form 



An LU requiring any other DSP value associated with medium select must do so 
by specifying the desired DSP in byte 3, bits 4-7 of the FMH-1. This 
selection must adhere to those DSPs allowed on the session as specified in 
the BIND parameters. 

Note 2: Media and logical subaddress values are reserved when DSSEL field is 
set to BUIO* (continue destination selection), B'001' (end), B'lOO 1 
(suspend), or B*101 f (end abort). 

Note 3: If medium = X'7* and logical subaddress = X f F f , DSNAME field is used 
to select destination. 
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SRI 

B'or 

B'l f 


B'O' 


B'l' 



Byte Bi t Content Weaning 

3 SRI Stack reference indicator 

Stack to be used is the sender's send stack. 
Stack to be used is the receiver's send stack. 

Demand select 

Recei ver may di rect data to alternate 

medi um/subaddress. 

Receiver must direct data to specified 

medi um/subaddress (spooling is prohibited). 

2-3 Reserved 

4-7 DSP Select Data stream profile (DSP) 

Profiles are: 
X f 0' Default DSP 
X«l» Base DSP 
X'2' General DSP 
X'3' Job DSP 
X'4* WP raw-form text DSP 
X*5* WP exchange diskette DSP 
X'A' Document interchange DSP 
X'B* Structured field DSP 

All other values reserved. 

Notes: If the DSP select field is X* f , the DSP i s implied by the medium 
select field. 

4 FMH-1 properties 

0-2 DSSEL Destination selection 

B'000* Resume destination selection 

B'OOl' End destination selection 

B'OIO 1 Begin destination selection 

■■■. B'-Oll* Begin/end destination selection 

B'100* Suspend destination selection 

B'101* End-abort destination selection 

B'llO* Continue destination selection 

BUll* Reserved 

3 DST Data set transmission 

B*0 T Transmission exchange format 
E'l* Basic exchange format 

When medium select -= exchange medium* this 
field is reserved. Receiver may do spooling 
and exchange-medium creation locally. 

When medium select = exchange medium (see byte 
2), specifying B*0 f preserves chain boundaries 
while spooling, but nonsequential allocation 
techniques may be used. Specifying B'l' does 
not preserve chain boundaries, but uses sequen- 
tial medium allocation. (See "Field 
Def ini ti on s" below. ) 

4 Reserved 

5 CMI Compression indicator (See "Notes" below.) 
B'O* No compression 

B'l* Compression 

6 CPI Compaction indicator (See "Notes" below. ) 
E'C No compaction 

B'l" Compaction 

7 Reserved 
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Byte Bi t Content Meaning 

5 0-7 ERCL Exchange record length if medium = exchange 

medium or card; otherwise reserved. For medium 
= card, a hexadecimal value indicates maximum 
card length. The value X f 00' indicates an 
80-column length. 

6-7 Reserved (optional) 

8 DSLEN Length of destination name (optional) 

9-n DSNAME Destination name (optional) (reserved when 

DSSEL = conti nue) 

Notes: 

1. CMI, CPI, and ERCL information received when DSSEL = continue overlays 
the settings of the BEGIN FMH-1 or the last-received CONTINUE FMH-1. 

2. CMI, CPI, and ERCL indicators are meaningful and valid only when speci- 
fied in a BEGIN, BEGIN/END, or CONTINUE FMH-1. 

3. If CMI or CPI is on, the first byte following the FMH (or FMHs) is a 
string control byte (SCB). 



FMH-1 Field Definitions 



Length: Specifies the variable number of bytes within the header, including 
the length byte. 

FM Header Concatenated (FMHC): Indicates the presence of a further FM header 
starting in the first byte following this FM header. Concatenated headers, 
which carry additional information concerning the destination identified by 
this type-1 header, are defined as type-2 headers. All concatenated FM head- 
ers must have the same setting of the Stack Reference Indicator. 

Type: Identifies the functional capability supported by the FM Header. FM 
header types 1 through 8 and 10 are defined in this book; types 40 through 4F 
are restricted for use by SNA implementations for private protocols; of 
those, X'40* through X'43" have been assigned. Types 50 to 7F are assigned 
for customer use. All other types are reserved. 

Medium Select: Identifies a device class to which the sender or receiver 
directs data. Each type of LU-LU session supports these media differently. 
Before selecting a medium, you should ensure that your LU-LU session provides 
the support you require. 

WP media 1 through 4 are word processing (WP) media and are defined by the 
implementation. 

Subaddress: Identifies a specific destination (device) to which the sender or 
receiver directs data. Up to 15 destinations may be explicitly selected. 
The capability to select any destination in the class (Subaddress = X'F') is 
also provided. In this case, assignment and selection of the specific desti- 
nation is done by the receiver of the FMH-1. 

The combination of length, medium select, and subaddress fields indicates the 
destination selection mechanism. 

a. Length < 6 is invalid. 

b. Length = 6: Medium select and subaddress are used to select the destina- 
ti on. 

c. Length > 6 has two possibilities: 

When the medium select and subaddress fields -= X*7F ? , the DSNAME field 
is used as a subselection field within the selected medium and subaddress 
(for example, data set on a disk) to identify the destination. 
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When the medium select and subaddress fields = X^F*, the DSNAME field is 
the data stream selected as the destination, and the medium and subad- 
dress fields are ignored. 

Stack Reference Indicator (SRI): Specifies to which destination this FMH-1 
applies. If an LU wants to refer to the destination it began or wants to 
begin* the bit is 0; if an LU wants to refer to the destination begun by the 
other LU, the bit is 1. 

Only two FMH-1 s can be sent with SRI = 1: 

END-ABORT (DSSEL = BU01'). 

BEGIN/END (DSSEL = B f 011 f ), but only for reply-type structured fields 
(DSP Select = X'B'). 

Demand Select: Indicates whether the receiver must direct data to the desti- 
nation specified in the medium and subaddress fields. 

Data Stream Profile (DSP) Select: Indicates the data stream profile to be 
used for the selected destination. A value other than X f 0* overrides the 
default DSP of the medium selected in the medium select field. 

Destination Selection (DSSEL): Indicates the beginning, suspension, resump- 
tion, continuation, and ending of a destination. The functions performed by 
these bits are consistent across all destinations. 

RESUME (B T 000*) reactivates a previously suspended destination. The destina- 
tion that is the second entry in the stack is made the active destination by 
moving the entry to the top of the stack. All FMH-1 fields except Length, 
FMHC, and DSSEL are ignored. The top entry in the stack must be empty prior 
to issuing a RESUME FMH-1. 

END (B'001 1 ) normally terminates the active destination at the end of the 
present chain. At the completion of the operation, the top entry in the stack 

i s empty. 

BEGIN (B f 010 T ) identifies a new destination. The destination becomes the top 
entry in the stack — the active destination. The destination remains active 
until an END, END-ABORT, or SUSPEND FMH-1 is issued. 

BEGIN/END (B'Oll 1 ) identifies a new destination for the duration of the 
chain. The destination remains the active destination until the end of the 
chain is detected; then it is removed from the top entry in the stack. At the 
end of the operation, the top entry is empty. 

SUSPEND (B'lOO') moves the top entry (the active destination) in the stack to 
the second entry, thus suspending the active destination. The RU should 
contain only the SUSPEND FMH-1; all other RU contents are ignored. At the 
completion of the operation, the top entry is empty. 

END-ABORT (B'101*) immediately terminates the active destination. The 
END-ABORT FMH-1 must be the only contents of the RU. At the end of the opera- 
tion, the top entry of the stack is empty. (The stack reference indicator 
(SRI) defines which stack is affected.) 

CONTINUE (B*110') enables you to change the compression, compaction, and 
exchange-record-length characteristics of the active destination. The 
CONTINUE FMH-1 alters the CMI, CPI, and ERCL fields previously defined by the 
BEGIN FMH-1 that established the active destination. 

Data Set Transmission (DST): Signals that the RU format (beyond this FMH-1 or 
concatenated FMH~2s) is either user defined (transmission format) or the 
basic-exchange format. If DST specifies basic-exchange format, then Medium 
Select should specify exchange format (X f l"). 

Compression Indicator (CMI): Indicates, if CMI = 1, that the RU contains 
compressed data. When CMI = 1, a string control byte (SCB) must follow either 
this FMH-1 or the concatenated FMH~2s. 

Compaction Indicator (CPI): Indicates, if CPI = 1, that the RU contains 
compacted data. When CPI = 1, a string control byte (SCB) must follow either 
this FMH-1 or the concatenated FMH-2s. 
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Exchange Record Length (ERCL): Specifies the length of the records that 
follow the FM headers and SCBs (if present). ERCL is specified in hexadeci- 
mal and is provided to assist the receiver in deblocking the subsequent data 
stream. 



When the medium select field specifies Card (X'2'), ERCL indicates the maxi- 
mum presentation position (MPP) for the card medium. The ERCL value X'OO* 
indicates an 80-column length. 

When the medium select field specifies exchange (X f l f ) and the destination 
selection is for existing data (for example, a previously created diskette 
data set), ERCL must equal the record length of the existing data. If the 
selection is for new data, ERCL indicates the record length of the data set to 
be created. An ERCL value of X f 00 f instructs the receiver to use the value 
associated with existing data; if there is no existing data, the receiver may 
choose a default. 

ERCL values for the basic-exchange format cannot exceed 128 bytes. The data 
is stored on diskette as fixed records, padded with nulls to 128 bytes, if 
necessary. 

Destination-Name Length (DSLEN): Specifies the length in bytes of the DSNAME 
field. This field may be omitted when DSNAME is omitted. 



Destination Name (DSNAME). 
This field may be omitted. 



Specifies a variable-length destination name. 



FUNCTION MANAGEMENT HEADER TYPE 2 (FMH-2) 

The format of an FMH-2 is shown below. Fields that are common to all FMH-2 
formats are discussed. Parameter fields (bytes 3 to n) are not discussed 
here; they will be described as each FMH-2 is defined. 

Byte 2 of the FMH-2 defines the function to be performed by the FMH-2 and 
contains the stack reference indicator (SRI). Figure 4-8 shows valid combi 
nations of SRI and function codes. 



Function 
Code 



Functi on 



Peripheral data information record (PDIR) 

Compaction table 

Prime compression character 

Execute program offline 

Create data set 

Scratch data set 

Erase data set 

Password 

Add 

Replace 

Add replicate 

Replace replicate 

Query for data set 

Note 

Record ID 

Erase record 

Scratch all data sets 

Volume ID 

Note reply (SRI is always on) 

Figure 4-8. FMH-2 functions and their function codes. 



X' 


01« 


X 


02* 


X 


04* 


X 


'07' 


X 


20' 


X 


21' 


X 


22' 


X 


23 f 


X 


'24' 


X 


25* 


X 


26' 


X 


27' 


X 


28* 


X 


r 29 » 


X 


'2B» 


X 


'2C 


X 


'2D' 


X 


2E» 


X 


'AA f 
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General Format: 



Byte 


Bit 


Content 







Length 


1 





FMHC 
B'O' 




1-7 


B' 0000010 


2 





SRI 
B'O' 



..B'l 1 

1-7 Function 

B'nnnnnnn' 



3-n 



Parms 



Weaning 

Length of header including length byte 

FMH concatenation* 

No FMH follows this FMH-2 

Another FMH follows this FMH-2 

FMH-2 identifier 

Stack reference indicator. 

FMH-2 pertains to the active destination of the 

sending half-session* s send stack and the 

receiving half-session's receive stack. 

FMH-2 pertai ns to the active destination of the 

receiving half-session's send stack and the 

sending half-session's receive stack. 



FMH-2 function to be performed. 

Identifies the function that this FMH-2 
perform. 



i s to 



Note: The FMH-2 descriptions on the following 
pages combine the SRI and function settings. 
Figure 4-8 shows valid settings for these 
fields. 

Parameter fields. These fields provide the 
information needed to perform the selected 
function. They are different for each FMH-2 
function. See the individual FMH-2 
descriptions below for definitions of the 
parameter fields. 



ADD 



Adds a record to a sequential, an addressed direct, or a keyed direct data set 
named in the FMH-1. For sequential data sets, ADD moves the end-of-data 
indicator to the next available record indicator. For keyed direct data 
sets, ADD establishes a valid record ID. For addressed direct data sets, ADD 
moves the end-of-data indicator and establishes a valid record ID. 



Bvte 


1 



Bi t Content Meani nq 

Length Length of header including length byte 

FMHC FMH concatenation. 

B'0' No FMH follows 

B'l' Another FMH follows 

1-7 B'0000010' FMH-2 identifier 

X'24» Add FMH-2 

N Number of records to be added 



Field Description: 

N Specifies the number of logical records to be added, which are contained 
in a chain. If the parameter N is not present in the ADD FMH-2 Clength of 
header = 3), then one record at a time is to be added to the data set 
named and each chain contains one logical record. 
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Notes; 

1. Key information is carried in the record. 

2. A BEGIN FMH-1 followed by FM data causes the sequential addition of a 
record to the data set named in the BEGIN FMH-1, A record is a chain. 

3. If the number of logical records in a chain is less than N, then the chain 
length overrides N. 

4. The logical record length (LRECL) may also be specified. Its presence or 
absence i s dependent on the data set selected by the FMH-1. However, 
LRECL information is not part of the FMH-2. If present, LRECL is part of 
each logical record. 

The logical record(s) may be sent or received immediately following the 
FMH-2 as part of one chain or in the next chain. LRECL is the first four 
bytes of a logical record and specifies the length, in bytes, of each 
logical record. The maximum value is 32,760. 

Errors: 

Record too long (X» 10080813* ) 

Data set full (X' 10080814* ) 

Number of logical records per chain exceeded (X 1 10080818 f ) 

Data set not found CXU008081D* ) 



ADD REPLICATE 



Replicates (duplicates) a record a specified number of times for the sequen- 
tial or addressed direct data set named by the FMH-1. Replication starts at 
the end-of-data indicator. ADD REPLICATE is not valid for keyed direct or 
keyed indexed data sets. 

Bvte Bi t Content Meaning 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'0* No FMH follows 
B'l' Another FMH follows 

1-7 B*0000010* FMH-2 identifier 

2 X'26* Add Replicate FMH-2 

3 R Replication factor 

Field Description: 

R Indicates the number of times the record is to be replicated. The record 
either follows the FMH-2 or is sent as the next chain. 

Errors: 

Function not allowed for destination (X*1008Q812* ) 
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COMPACTION TABLE 



Sends a compaction table for use by the destination specified in the FMH-1. 



Byte 




Bit 



1-7 



Content 

Length 

FMHC 
B*0» 

B'l' 

B'0000010 

X f 02' 

N 
X'00 f 



X'Ol 1 
X'Q2' 
X'OS'-X'IO' 



Table 



Meaning 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Compaction Table FMH-2 

Number of master characters. 

Ignore previously sent table. The value X^O* 
is used to tell the session partner that subse- 
quent data is no longer compacted. 
Invalid (see "Errors") 
Invalid (see "Errors") 
Number of master characters in the table. 

Implementations may specify a larger minimum 
than N = X'03* . 

Characters to be compacted followed by remain- 
ing characters. (Transmitted in row major 
order, starting at the bottom row and omitting 
the cells in the upper left corner M-by-M 
submatrix. (See "Selecting a Compaction Table" 
in Part 2 Chapter 5 and the example below for 
further details.) 

Characters need not be graphics; controls such 
as new line (NL), form feed (FF)> duplicate 
(DUP), and horizontal tab (HT) may be used. 



Errors: 

Compaction table outside supported subset (X* 10080806 * ) . (The number of 
master characters does not fall within the valid range.) 

Example: 

A table of 14 master characters has been chosen for numerical reports that 
contain numbers, uppercase graphics, and special characters. To use the 
table, the following header is sent: 

First 3 bytes: X f 400202* (For FMH-2) 



Next byte: 
Next 14 bytes: 

Next 18 bytes: 



X'OE* 



(For 14 master characters) 



EBCDIC value of the following characters: 
0123456789.,-* 

EBCDIC value of the following characters: 
'=( + |&$*);-/%_>:*3> 



Next 28 bytes: Hexadecimal representation of the following 
characters: 
$<YZWXUVSTQROPMNKLIJGHEFCDAB 
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0123456789ABCD 


E F 







A b! 


1 


M-by-M Submatrix 


C D| 


2 




E F| 


3 




G H| 


4 




I Jl 


5 


These are compacted 


K L| 


6 


codes. X f 53 f expands 


M N| 


7 


to a character 


P| 


8 


string of 53, for 


Q Rl 


9 


example. 


S T| 


A 




U VI 


B 




W XI 


C 




Y Z| 


D 




« <l 

* ai 


E 


(+!&$*);-/% >: 


F 


0123456789.,-* 


i — 



The last row contains the master characters, 
assigned to X'Fn' for n=0....D 

Sample input string for this table: ABC2XY4568 

Coded String 

X'OES X'OF', X'lE', X'F2', X'BF», X'CE», X'45 1 , X'68' 

In this example, only the last four characters are compactable. 



CREATE DATA SET 



Creates a data set entry 
may be added. 



Byte 




6-7 
8-11 



Bit 



1-7 



Content 

Length 

FMHC 
B'O 1 
B'l' 

B' 0000011 

X'20 f 

DSACCESS 

X'00' 

X'Q1» 

X'02 f 

X'81' 



ACCESS 

X'00 f 

X f 01' 



RECTYPE 

X'00' 

X'01' 

RECLEN 
NUMRECS 



in a directory for a data set to which data records 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Create Data Set FMH-2 

Data set access method 

Sequential 

Addressed direct - basic 

Keyed direct - unique 

Addressed direct - restricted 

All other codes reserved 

Local application access 

Read/wri te 

Read only 

All other codes reserved 

Fixed- or variable-length records 
Fixed length 
Variable length 

Record length (hexadecimal value, 
right-justified, zero-padded) 

Number of records (hexadecimal value, 
right-justified, zero-padded) All zeros indi- 
cate system default. 
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The remaining fields are optional: 
PASSR 



12-n 
n+l-p 



PASSU! 



Password for read access for users of the data 
set being created. Characters left-justified. 

Password for read/write access and to allow 
erasure. Characters left-justified. 

If the respective passwords are not present, 
PASSR and PASSW are X'OO'. If the respective 
passwords are present, X^x 1 indicates the 
length of the password. 



The following fields occur for keyed direct data sets only: 



w 



KEY1LEN 

KEY1DISP 

KEY1TECH 

X'01' 

X'02' 

KEY1SPACE 
KEY2LEN 

KEY2DISP 
KEY2TECH 



Length of key 1 CI byte) 

Displacement to key 1 (2 bytes) 

Type of key-1 algorithm (1 byte) 
Hash type 1 
Hash type 2 

Resolution space (2 bytes) (hexadecimal value, 
right-justified, zero-padded.) 

Field definitions for bytes v to y are the same 
as for bytes r to u except for the different 
key. 



y KEY2SPACE 

Field Descriptions: 

DSACCESS This field defines the type of access to the data set being 

created. The type selected affects the remaining information 
carried in the header. The following types of data set access are 
defined: 

Sequential : Records may be added to or erased from the data set; 
the data set may be queried (read). 

Addressed Direct - Basic: Records may be added and subsequently 
replaced, erased or queried. The data set is created with the 
end-of-data indicator pointing to the first available record. 

Addressed Pi rect - Restricted: Records may be replaced, erased or 
the data set queried. The data set is created with the end-of-data 
indicator pointing one past the last available Record Identifier. 
The logical records in the data set are not initialized to a 
particular value. This must be done via the REPLACE FMH-2. If 
this data i squeri ed following its creation, noni ni tiali zed 
logical records are returned. 

Keyed Direct - Unique: Records may be added, erased, or queried. 

ACCESS This field defines the local access capability to be applied to the 
data set — read/write or read only. 

RECTYPE Indicates whether the data set records are fixed or variable 

length. Fixed length must be specified for addressed di rect data 
sets; fixed and variable length are valid for sequential and keyed 
direct - unique data sets. 

RECLEN Indicates the maximum logical record length when RECTYPE is vari- 
able, and actual record length when RECTYPE is fixed. 

NUMRECS This value is used to assist in space allocation for sequential and 
addressed direct data sets. It indicates the maximum number of 
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ERASE 



records available for subsequent processing. This field has no 
meaning for keyed direct and keyed indexed data sets. 

PASSR This is an optional parameter used to assign a password for read 
access to the created data set. 

PASSW This is an optional parameter used to assign a password for 
read/write access and erase capability. 

KEY1LEN This parameter indicates the length of the key of a keyed direct 

data set or the length of the first key of a double-keyed data set. 

KEY1DISP This parameter defines the displacement from the beginning of each 
record in the data set to the start of the key. 

KEY1TECH This parameter indicates the type of key processing. 

KEY1SPACE This parameter indicates the amount of space to be allocated for 
resolution of keyed records. 

Note: 

1. A VOLUME-ID FMH-2 must be concatenated to the previous FMH-1 if the data 
set i s to be created on other than the default volume. 

Errors; 

Data set exists CX T 10080819' ) 
No space available (X'1008081A» ) 
Invalid DSACCESS (X' 1008081C 1 ) 
Invalid RECTYPE CX' 1008081D' ) 
Invalid ACCESS (X'1008080C) 
Invalid RECLEN (X' 1008080D' ) 
Invalid NUMRECS (X' 1008080E* ) 
Insufficient resolution space (X f 1008081E* ) 

Invalid key technique, for example, KEY1TECH=X»20 * CX T 1008081F 1 ) 
Invalid key displacement, for example, displacement outside of record length 
(X T 10080820») 



Erases one or more records from a data set identified in the FMH-1 so that 
record(s) can no longer be accessed. The RECORD-ID FMH-2 indicates the 
starting point of the erase operation. ERASE is valid for Addressed Direct 
and Keyed Direct data sets only. 

Bvte Bit Content Meani ng 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'O' No FMH follows 
B'l 1 Another FMH follows 

1-7 B T 0000010* FMH-2 identifier 

2 X f 2C Erase (a record) FMH-2 

3 N Number of records to be erased. 

Field Description: 

N For addressed and keyed direct data sets, N specifies the number of 

records to be erased precedi ng the end-of-data indicator. If N is not 
present in the FMH-2 for addressed direct data sets, records are erased 
from the key indicated in the RECORD-ID FMH-2 to the end-of-data indica- 
tor. If N i s not specif i ed, for keyed direct data sets, ERASE erases a 
single record indicated by the RECORD-ID FMH-2. If N is specified for 
keyed direct data sets, N must be one. 
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Errors: 

Function not allowed for data set (X* 10080812* ) 

Data set in use (X' 1008080F* ) 

Invalid N (N must be 1 if specified for keyed direct data sets) (X'10080822* ) 



ERASE DATA SET 



Erases the records within a data set but leaves the data set entry in a direc- 
tory intact. Records may subsequently be added to the data set without 
requiring a CREATE DATA SET FMH-2. 

Meaning 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Erase Data Set FMH-2 



1. If a VOLUME-ID FMH-2 is not concatenated to the previous FMH-1, or not 
supported* and a cataloged structure does not exi st> the receiving LU 
finds the data set specified by DSNAME in the FMH-1 by serially searching 
the mounted volumes. The records in the first data set name to match are 
erased. 

2. If a VOLUME-ID FMH-2 is not concatenated to the previous FMH-1, or not 
supported, and a catalog structure exi sts, the records in the first cata- 
loged data set specified by DSNAME are erased. 

Errors: 

Data set not found (X* 10080810* ) 

Function not allowed for data set (X* 10080812' ) 

Data set in use (X'1008080F* ) 



Bvte 


Bit 


Content 







Length 


1 





FMHC 
B'O' 
B'l' 




1-7 


B'0000010 


2 




X'22* 


Notes: 







EXECUTE PROGRAM OFFLINE 



Requests the scheduling of a program for execution when the LU-LU session 
ends. 

Meaning 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Execute Program Offline FMH-2 

Reserved 

Length of program name (in hex) 

Number or name of program to be executed (bina- 
ry encoded) 



Bvte 


Bit 


Content 







Length 


1 





FMHC 
B*0* 
B'l' 




1-7 


B»0000010 f 


2 




X'07' 


3 






4 




LENAME 


5-n 




P6MNAME 
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Errors: 

Insufficient resources to perform function requested (X f 1008400D 1 ) 
Invalid PGMNAME — PGMNAME not found (X» 1008082A' ) 



NOTE 



Requests the next available record indicator (ID) for the data set named in 
the FMH-1. The next available record ID is returned by the NOTE REPLY FMH-2, 
and it must be returned in the next FMH-2 the session partner sends. 

Byte Bit Content Meani ng 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'0 T No FMH follows 
B'l' Another FMH follows 

1-7 B'OOOOOIO* FMH-2 identifier 

2 X T 29» Note FMH-2 
Errors: 

Function not allowed for data set (X» 10080812* ) 



NOTE REPLY 



Provides the next available record indicator (ID) to the sender of the NOTE 
FMH-2. The ID must be returned in the next FMH-2 sent to the session partner 
after the NOTE FMH-2 is received. 

Bvte Bit Content Meani ng 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'0 T No FMH follows 
B'l' Another FMH follows 

1-7 B'0000010' FMH-2 identifier 

2 X'AA' Note Reply FMH-2 

Note: The high-order bit (the SRI bit) is set 
to one, thus pointing to the active destination 
of the session partner's send stack. 

3-n RECID Address of the next available record 

Errors: None 
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PASSWORD 



Validates the authority of the requester to refer to and change data sets and 
data set records. This header may be used to establi sh authority for a named 
destination (via an FMH-1) so that subsequent FMH-2 operations may be 
performed. 



Byte 




Bit 


Content 


Meaning 









Length 


Length of header in< 


1 







FMHC 
B'0» 

B»l' 


FMH concatenation. 
No FMH follows 
Another FMH follows 






1-7 


B'0000010 1 


FMH-2 identifier 


2 






X'23' 


Password FMH-2 


3-n 






Password 


Password 


Field 


De 


script 


ion: 





Password The word used to validate the authority of the requester. Password 
must have been specified in the PASSR and PASSU! parameters of the 
CREATE DATA SET FMH-2. 

Errors: 

Invalid password (X'10080811' ) 
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PERIPHERAL DATA INFORMATION RECORD (PDIR) 



Requests that the operator perform forms mount, electronic forms control 
load, train mount, and copy functions. 



B yte 

1 



2 
3 

4-11 

12-19 

20-27 

28-35 

36-43 
44-51 

52-59 



M± 



1-7 



60-99 



Content 

Length 

FMHC 
B'0» 
B'l' 

B'0000010 

X'Ol* 

PDIR ID 
X'00 T 
X T 01' 
X T 02* 

DATE 
TIME 
FORMS 



FCBNAME 



TRAIN 



COPIES 



VOLIO 



DSN 



Meani nq 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

PDIR FMH-2 

Request identifier. 
Standard PDIR 
Job separator PDIR 
System message PDIR 

Date of data set creation, in EBCDIC 
characters. Format: MM/DD/YY Default: 00/00/00 

Time of data set creation, in EBCDIC 
characters. Format: HH.MM.SS Default: 00.00.00 

Forms to be handled by the operator, in EBCDIC 
characters, left-justified, blank-padded. 
Default: blanks, indicating use of the standard 
forms. 

FCB name to be used to have the session partner 
load a printer FCB (electronic forms control 
buffer) image. EBCDIC characters. Default: 
blanks, indicating use of the standard FCB. 

Train name (train to be mounted) in EBCDIC 
characters Default: blanks, indicating use of 
the standard train. 

Number of additional copies to be reproduced. 
EBCDIC characters right-justified, 
blank-padded (except for rightmost position). 
Default = bbbbbbbO 

Volume of I/O in EBCDIC characters, 
right-justified, suppress leading zeros. Spec- 
ify the number of print lines or the number of 
cards. Default: blanks. 

VOLIO provides the operator with information 
concerning the relative length of jobs. The 
value of the parameter therefore need not be 
precise. 

DSNAME field, EBCDIC characters, 
left-justified, blank-padded. Default = 
blanks. 



The DSNAME field is 
JOBNAME (bytes 60- 



as follows: 



subdi vi ded 

67) 

STEPNAME (bytes 68-75) 
PROCSTEP (bytes 76-83) 
DDNAME (bytes 84-91) 
SPINNO (bytes 92-99) 



SPINNO (spin number) is a unique identifier 
distinguish among data sets with the same 
JOBNAME. 



to 
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Note: 

1. If a PDIR with the COPIES function specified is received and accepted, 
the sender transmits the data to be copied n times only once. That is, 
the receiver of such a PDIR performs the copy function. 

Errors: 

Invalid function parameters (X'10080801» ) 

Forms function cannot be performed (X' 10080803' ) 

Unable to perform copy function (X f 10080805' ) 

Invalid PDIR identifier CX' 10080807 ' ) 

Printer train function cannot be performed CX' 10080808* ) 

FCB load function cannot be performed CX' 10080809' ) 



PRIME COMPRESSION CHARACTER 



Sends a prime compression character for use by the destination specified in 
the FMH-1. The prime character is assumed to be the character blank. If 
another character is required, this FMH-2 should be sent. 

Bvte Bit Content Meaning 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'0' No FMH follows 
B'l' Another FMH follows 

1-7 B'0000010* FMH-2 identifier 

2 X'04' Prime Compression Character FMH-2 

i c i nit: » 

blank. 
Errors: None 



/*i _j.__ 



QUERY FOR DATA SET 



Requests that the data set named by the FMH-1 be sent to the requester. QUERY 
FOR DATA SET is valid for sequential, addressed direct, and keyed direct data 
sets. 

Bvte Bi t Content Meaning 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'0' No FMH follows 
B'l' Another FMH follows 

1-7 B'0000010' FMH-2 identifier 

2 X'28' Query for a Data Set FMH-2 

3 Mode Query mode. 
X'00' Immediate reply 
X'01* Delayed reply 

Field Description: 

Mode If immediate reply is specified, the requested data must be sent with 
the next BEGIN or BEGIN/END FMH-1. If delayed reply is specified, the 
requested data may be sent on any subsequent BEGIN or BEGIN/END FMH-1. 
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Error: 

Data set not found CX' 10080810* ) 



RECORD ID 



Selects a specific record within a data set named by the FMH-1. 
Bvte Bi t Content Meani ng 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

No FMH follows 
Another FMH follows 

1-7 B'0000010* FMH-2 identifier 

Record ID FMH-2 

Key indicator. 
Addressed direct key 
Keyed direct KEY1 
Keyed direct KEY2 
Implementation definition 
Control definition 
Keyed direct Key 3 
Keyed direct Key 4 
Keyed direct Key 5 
Keyed direct Key 6 
Keyed direct Key 7 
Keyed direct Key 8 

4-n RECID Key of record to be selected. 

Notes; 

1. For the ADD FMH-2 and REPLACE REPLICATE FMH-2, specify KEYIND of X'OO*. 

2. For the REPLACE FMH-2 and ERASE FMH-2, specify KEYIND of X f 00' if 
addressed direct data set or X'01', X'02», X'05', X'06', X f 07», X f 08», 
X'Q9', or X'OA' if keyed direct data set. 

3. The VOLUME-ID FMH-2 must precede the root FMH-2 that this RECORD-ID FMH-2 
accompanies to protect against accessing an identically named data set on 
another volume. 

Errors: 

Invalid RECID CX T 10080815* ) 
Invalid KEYIND CX' 10080823 * ) 
Invalid RECID format (X' 10080826* ) 



Content 


Length 


FMHC 


B' 


0' 


B' 


1* 


B 1 


0000010* 


X' 


2B* 


KEYIND 


X' 


'00* 


X" 


'01* 


X' 


f 02* 


X' 


f 03* 


X' 


'04* 


X' 


'05* 


X' 


'06' 


X 1 


'07* 


X' 


'08' 


X' 


( 09* 


X' 


r 0A f 
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REPLACE 



Replaces one or more logical records within the data set named by the FMH-1 
with an equal number of logical records. The RECORD-ID FMH-2 indicates the 
starting point of the replace operation. The end- of- data indicator does not 
change. 

Meaning 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Replace Record FMH-2 

Number of records to be replaced 



Byte 




Bit 


Content 









Length 


1 







FMHC 
B'O' 






1-7 


B'0000010 


2 






X*25 f 


3 






N 


Field 


Descri pt 


i on: 


N Sr 


aeci 


f i es 


the number c 



Specifies the number of logical records to be replaced which are 
contained in a chain. If N is not present in the REPLACE FMH-2 (len 
header is. 3), then one record i s to be replaced in the data -- J " --* — 
time and each chain contains one logical record. 



gth of 
set named at a 



Notes: 



1. The logical length (LRECL) may also be specified. Its presence or 
absence is dependent on the data set selected by the FMH-1. However, 
LRECL information is not part of the FMH-2. If present, LRECL is part of 
each logical record. 

2. The logical recordCs) may be sent or received immediately followi ng the 
REPLACE FMH-2 as part of one chain or in the next chain. LRECL i s the 
first four bytes of a logical record and specifies the length, in bytes, 
of each logical record. The maximum value is 32,760. 

Errors: 

Function not allowed for destination (X f 10080812* ) 
Data set in use (X'100808aF' ) 
Invalid N (X» 10080822' ) 
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REPLACE REPLICATE 



Replaces one or more logical records within the data set named by the FMH-1 
with an equal number of identical logical records. The RECORD-ID FMH-2 indi- 
cates the starting point of the replace operation. The end-of-data indicator 
does not change. REPLACE REPLICATE is valid for addressed direct data sets 
only. 

Bvte Bi t Content Weaning 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B'O' No FMH follows 
B'l 1 Another FMH follows 

1-7 B'OOOOOIO 1 FMH-2 identifier 

2 X'27* Replace Replicate FMH-2 

3 R Replication factor 

Field Description: 

R Indicates the number of records to be replaced with the record that 

follows. The replication record either follows the FMH-2 or is sent as 
the next chain following the header. 

Errors: 

Function not allowed for the data set (X , 10080812 f ) 
Data set in use (X 1 1008080F' ) 



SCRATCH ALL DATA SETS 



Deletes all data set entries in a directory for the medium* subaddress, and 
volume-ID specified. Before this FMH-2 is issued, the medium and subaddress 
are specified in an FMH-1, and the volume ID is specified in a VOLUME-ID 
FMH-2. 

Bvte Bi t Content Meaning 

Length Length of header including length byte 

1 FMHC FMH concatenation. 

B f f No FMH follows 
B«l' Another FMH follows 

1-7 B f 0000010 f FMH-2 identifier 

2 X T 2D» Scratch (erase) All Data Sets FMH-2 
Notes: 

1. If DSNAME is specified in the preceding FMH-1, it is ignored. 

2. If a VOLUME-ID FMH-2 is not specified or not supported, the directory 
entries for all data sets on the medium and subaddress sre deleted. 

Errors: 

Function not allowed for destination (XUOOSOS^ 1 ) 
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SCRATCH DATA SET 



VOLUME ID 



Deletes the data set entry from a directory for the named data set so that the 
data set can no longer be referenced. The space associated with the data set 
name is also freed. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Scratch Data Set FMH-2 



1. If a VOLUME-ID FMH-2 is not concatenated to a previous FMH-1, or not 
supported, and a cataloged structure does not exi st > the receiving LU 
finds the data set specified by DSNAME in the FMH-1 by serially searching 
the mounted volumes. The first data set name to match is scratched. 

2. If a VOLUME-ID FMH-2 is not concatenated to a previous FMH-1, or not 
supported, and a catalog structure exi sts> the first data set specified 
by DSNAME found in the catalog is scratched. 

Errors: 

Data set in use (X' 1008080F' ) 
Data set not found (X' 10080810' ) 



Byte 


Bit 


Content 







Length 


1 





FMHC 
B'O' 
B'l' 




1-7 


B'0000010' 


2 




X'21' 


Notes: 







Specifies a volume ID to be associated with the data set named by the FMH-1 
VOLUME ID is not a mount function. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-2 identifier 

Volume-ID FMH-2 

Volume ID 



Invalid VOLID (X' 1008081B' ) 
Invalid VOLID format CX' 10080817' ) 



Byte 


Bit 


Content 







Length 


1 





FMHC 
B'O' 

B'l' 




1-7 


B'0000010' 


2 




X'2E' 


3-n 




VOLID 


Errors: 
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FUNCTION MANAGEMENT HEADER TYPE 3 (FMH-3) 

General Format: The FMH-3 format is identical to the FMH-2 format except that 
FMH-3s do not have a stack reference indicator (SRI) in byte 2. 

An FMH-3 is used when information is needed or used by all destinations 
managed by the half-session. By contrast* an FMH-2 is used for a specific 
desti nati on. 

Two functions, the COMPACTION TABLE FMH and the PRIME COMPRESSION CHARACTER 
FMH> can be sent as FMH-2s or FMH-3s. They should be sent as FMH-2s when they 
apply to a specific destination at the half-session and as FMH-3s when they 
apply to all destinations at the half-session. 

Figure 4-9 shows the FMH-3 functions. 



Function 
Code 

X'02' 
X'03» 
X T 04 f 
X f 05 f 
X'06' 



Functi on 

Compaction table 

Query for compaction table 

Prime compression character 

Status 

Series ID 



Figure 4-9. FMH-3 functions and their function codes. 



COMPACTION TABLE 



Sends a compaction table for use by all destinations at the half-session. 



Bvte 




Bit 


Content 




Length 





FMHC 
B T 0' 


1-7 


B'OOOOOll' 




X T 02' 




N 
X f 00» 




X'01' 
X'02' 
X'OS'-X'IO* 



Table 



Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 

FMH-3 

Compaction Table FMH-3 

Number of master characters. 

Ignore previously sent table. The value X*00 T 
is used to tell the session partner that subse- 
quent data is no longer compacted. 
Invalid (see "Errors"). 
Invalid (see "Errors"). 
Number of master characters in the table. 

Implementations may specify a larger minimum 
than N = X'03' . 

Characters to be compacted followed by remain- 
ing characters. Transmitted in row major 
order, starting at the bottom row and omitting 
the cells in the upper left corner M-by-M 
submatrix. (See "Selecting a Compaction Table" 
in Part 2 Chapter 5 for further details.) Chai — 
acters need not be graphics; controls such as 
new line (NL), form feed (FF), duplicate (DUP), 
and horizontal tab (HT) may be used. An example 
of a table is shown under "Compaction Table 
FMH-2" on page 215. 
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Errors: 

Compaction table outside supported subset (X* 10080806 T ) (The number of master 
characters does not fall within valid range.) 



PRIME COMPRESSION CHARACTER 



Sends a prime compression character for use by all destinations at the 
half-session. The prime character is assumed to be the character blank. If 
another character is required, this FMH-3 should be sent. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 

FMH-3 

Prime Compression Character FMH-3 

Prime compression character if other than 
blank. 



Bvte 




Bit 


Content 









Length 


1 







FMHC 
B'O' 






1-7 


B'0000011' 


2 






X f 04» 


3 






Character 


Errors: 


N 


one 





QUERY FOR COMPACTION TABLE 



Requests that the receiver send the named compaction table. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 

FMH-3 

Query for a Compaction Table FMH-3 

Name of the. table 

Invalid compaction table name (X 1 1008080B f ) 



Bvte 


Bit 


Content 







Length 


1 





FMHC 
B'O' 




1-7 


B f 0000011 f 


2 




X f 03* 


3-n 




CPTBL 


Errors: 
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SERIES ID 



Establishes a 4-byte unique identification (ID) for a series of FM headers to 
assist in correlating the completion of a series of operations. The series 
is delineated by sending another SERIES-ID FMH-3. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-3 

Series ID FMH-3 

Series identifier 



SERID A 4-byte unique identifier to be applied to subsequent FMH opei — 
ations. 



Byte 




Bit 


Content 









Length 


1 





1 


FMHC 
B'O' 
B'l' 






1-7 


B'0000011' 


2 






X'06' 


3-6 






SERID 


Field 


D 


escript 


i on: 



Errors: 

Invalid SERID CX' 10080824' ) 



STATUS 



Communicates the state of completion of a series, user application program, 
or DSNAME by conveying two bytes of user sense information. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-3 

Status FMH-3 

User-specified status 

Type of status. 

Series ID 

User application program 

DSNAME 

Series ID, or user application program name, or 
data set name. 



Byte 


Bit 


Content 







Length 


1 



1 


FMHC 
B'O' 
B'l' 




1-7 


B'0000011 


2 




X'05' 


3-4 




Sense 


5 




STAT 
X'01' 
X'02' 
X»03' 


6-n 




STATITEM 


Errors: 


None 
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FUNCTION MANAGEMENT HEADER TYPE 4 (FMH-3) 



FMH-4 is used by the sending 
subset of a logical message) 
by the session partner. 



Byte 


Bit 


Content 







FMHL 


1 



1-7 


FMHC 
B'0000100* 


2 




FMH4FXCT 



m 

m+1 

n 
n+1 

P 
P+l 



0-5 
6 



FMH4TT1 



X'OO 
X'40 
X'41 
X'42 
X'43 
X'50 
X'FF 



-X f 3F f 



-X*4F' 
-X'FE' 



FMH4TT2 



FMH4CMD 

X'00' 

Other 

FMH4FLAG 

FMH4BDTF 
B'O' 
B'l' 
FMH4RDTF 

FMH4LBN 



FMH4BN 

FMH4LBDT 

FMH4BDT 

FMH4LVID 

FMH4VID 



half-session to describe a block of data (a 

and what to do with the data when it is received 



Meaning 

Length of header including length byte (>6) 

FMH concatenation (must be B*0'). 
FMH-4 identifier 

Length of fixed length parameters excluding the 
length of FMH4FXCT. The first nonfixed parame- 
ter position is FMH4LBN. The minimum value of 
FMH4FXCT is 3. The maximum value is 4. 

Block transmission type 

Reserved 

FFR-FNI record 

FFR-FS record 

FFR-FS2 record 

Reserved 

Reserved 

Deri vati ve code 

Block transmission type qualifier. Reserved 
except for FMH4TT1=X T 41 » or X'42 T , in which 
case it holds the separator value. 

Command 

Create 

Reserved 

Flags. If omitted, X*Q0 T is assumed. 

Reserved 

Block data transform flag 

FMH4BDT absent 

FMH4BDT present 

Reserved 

Length of FMH4BN. Zero, or omitted, if unnamed 
block. 

Name of block 

Length of FMH4BDT. Zero if FMH4BDTF is B f f . 

Block data transform 

Length of FMH4VID 

Version identifier 



FUNCTION MANAGEMENT HEADER TYPE 5 (FMH-5) 

FMH-5 is used by the sending half-session to attach a transaction program to 
the receiving half-session, to change parameters sent in a previous attach, 
or to reset (detach) a previously-attached transaction program. 
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ATTACH 



The ATTACH FMH-5 is sent by either LU_T6 half-session to select a named tran- 
saction program. The ATTACH FMH can be followed by other FM headers and FM 
data. The ATTACH FMH-5 can optionally be sent with BB> EB, or CD. 

Each variable-length field (those fields starting with byte 8) starts with a 
1- or 2-byte length field that indicates the number of bytes in the 
variable-length field. Field FMH5LNSZ indicates whether the length field is 
one or two bytes; the length indicated does not include the length byte(s). 



Bvte 




2-3 

4 



Bit 


Content 
Length 





FMHC 
B'O' 

B'l» 


1-7 


B'0000101' 




FMH5CMD 
X'0202' 





FMH5M0D 
FMH5LNSZ 




B'O' 
B'l' 


1-2 




3 


FMH5IUE 

B'O' 

B'l* 


4 




5 


FMH5IUA 

B'O' 

B'l' 


6-7 


FMH5IUT 

B'OO* 

B'01' 




FMH5FXCT 
X'02' 




ATTDSP 


0-3 


DSP 
X'O' 


4-7 


DSPMOD 




ATTDBA 

X'Ol' 

X'04' 



Meani nq 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-5 identifier 

Command code 
Attach FMH-5 



Length of length fields for variable- and 
fixed-length parameters 
Length field is 1 byte long 
Length field is 2 bytes long 

Reserved 

Interchange unit end indicator 
IU not terminated 
IU termi nated 

Reserved 

Interchange unit queue access 

Not session local queue 

Session local queue (only session partners can 

access queue) 

Interchange unit type 
IU spans more than one RU chain 
IU terminates at end of RU chain 
Others reserved 

Length of fixed length parameters 
Two bytes of parameters follow 

Data stream profile used by transaction program 

Data stream profile 
User def i ned 
Others reserved 

Modifier for usei — defined DSP. 

Appli cat i on data handli ng algori thm 
Variable length> variable blocked 
A chai n of RUs 
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Resource Names: 
8-m 



ATTDPN 



Field length (1 or 2 bytes depending on 
FMH5LNSZ) plus name of transaction program 
(DPN) to be initiated. For an IBM service 
(transaction) program, the DPN starts with a 
nongraphic; that is, the first byte has a value 
of X'OO* to X'SF'Csee list below). For all 
other programs, the DPN starts with a graphic 
(X'41 f to X'FE'). 



m+l-n 



n+l-p 



P+l-q 



q+l-r 



r+l-s 



ATTPRN 



ATTRDPN 



ATTRPRN 



ATTDQN 



ATTACC 



IBM service program 
System message program 
Scheduler program 
Queue program 
DL/1 program 



First bvte of name 



01 
02 
03 

05 



Field length (1 or 2 bytes depending on 
FMH5LNSZ) plus name of primary resource (PRN) 
for the transact! on program being initiated 

Field length (1 or 2 bytes depending on 
FMH5LNSZ) plus name of suggested return program 
name (RDPN) 

Field length (1 or 2 bytes depending on 
FMH5LNSZ) plus name of suggested primary 
resource for the return program (RPN) 

Field length (1 or 2 bytes depending on 
FMH5LNSZ) plus name of queue to be associated 
with the DPN 

Field length (1 or 2 bytes depending on 
FMH5LNSZ) plus access code to be validated 
before session is attached to transaction 
program (a symbolic name) 



Note: Variable- and fixed-length parameters are positional by command code. 
A length field, which is 1- or 2-bytes long depending on byte 5, precedes each 
variable-length positi onal parameter. If the length field is zero the vari- 
able parameter is omitted and the next positional variable-length parameter 
length field occurs followed by its variable-length parameter field. 
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DATA DESCRIPTOR 



The DATA DESCRIPTOR FMH-5 is sent by a half-session when it wishes to change 
the parameters passed in the initial ATTACH FMH-5 or previous DATA DESCRIPTOR 
FMH-5. The DATA DESCRIPTOR FMH-5 can be followed by other FM headers and FM 
data. The DATA DESCRIPTOR FMH-5 must be sent with BB. 



Bytq 




2-3 



Bit 


Content 
Length 





FMHC 
B'O' 

B'l' 


1-7 


B'0000101 




FMH5CMD 
X'0206» 




FMH5M0D 





FMH5LNSZ 




B'O' 

B'l' 


1-2 




3 


FMH5IUE 
B'O' 

B'l 1 


4-5 




6-7 


FMH5IUT 

B'00' 

B'Ol' 




FMH5FXCT 
X'02' 




ATTDSP 


0-3 


DSP 
X'O' 


4-7 


DSPMOD 




ATTDBA 

X'Ol' 

X'04' 



Meani nq 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-5 identifier 

Command code 

Data Descriptor FMH-5 



Length of length fields for variable- and 
fixed-length parameters 
Length field is 1 byte long 
Length field is 2 bytes long 

Reserved 

Interchange unit end indicator 
III not terminated 
IU terminated 

Reserved 

Interchange unit type 
Multiple-chain IU 
Single-chain IU 
Others reserved 

Length of fixed length parameters 
Two bytes of parameters follow 

Data stream profile used by transaction program 

Data stream profile 
User defined 

Modifier for user-defined DSP. Reserved when 
DSP -= X'O'. 

Application data handling algorithm 
Variable length* variable blocked 
A chain of RUs 
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RESET ATTACHED PROCESS (RAP) 



The RAP FMH-5 is sent to the attach manager in the receiving half-session to 
detach the transaction program currently attached. The RAP FMH-5 must be the 
only FMH in the chain and may not carry FM data. The RAP FMH-5 must carry CD 
and request a sync point (RQE2 or RQD2). 



Byte 








2-3 



1-7 



Content 
Length 

FMHC 
B'O' 
BT 



Meaning 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 



1-7 B'0000101 1 FMH-5 identifier 

FMH5CMD Command code 

X'0204' Reset Attached Process FMH-5 



FMH5M0D 
FMH5LNSZ 

B T T 

B'l' 



Length of length fields for 
variable- and fixed-length parameters 
Length field is one byte long 
Reserved 

Reserved 



FMH5FXCT Length of fixed length parameters 
X^OO" No parameters follow 



FMH-5 ERRORS 



Error 



Sense code 



Insuff ici ent 
Invalid DSP 
DPN unavailable 
PRN unavailable 



resource 



Invalid 

Invali d 

Invali d 

Invali d 

Invali d 

Invalid 

Fixed 

Wrong 

Invalid command 

Invalid RAP FMH 

RAP with inactive attach register 



DPN 

PRN 

DBA 

queue name length 

DSP 

ATTACH access code 
length not 2 
IUT, IUE not on 



0812uuuu 
080Fuuuu 
084B6002 
084B6003 
10036002 
10036003 
10086001 
10086004 
10086006 
10086008 
10086009 
1008600A 
1008600B 
1008600F 
10086010 
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FUNCTION MANAGEMENT HEADER TYPE 6 (FMH-6) 



Bvte 



Bit 


Content 
Length 


1 





FMHC 
B'O' 
B'l' 




1-7 


B'0000110* 


2-3 




FMH6CMD 



FMH-6 carries information that relates to work being done by the transaction 
programs at each end of a type 6 LU-LU session. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-6 identifier 

Command code (CC2) 

For IBM service (transaction) programs* the 
first byte of the command code identifies a 
program and the second byte identifies a func- 
tion request within the program. 

Modi f i er 

Length of parameter length fields 
One-byte parameter length field 
Two-byte parameter length field 

Reserved 

Total length of fixed length parameters (LF). 
This field contains the sum of the lengths of 
all fixed length parameters which are mandatory 
for the particular command code located in 
bytes 2 and 3. This field is either one byte or 
two bytes in length based on the setting of 
FMH6LNSZ (0 = one byte, 1 = two bytes). 

Fixed length parameters (FDy). The fixed 
length parameters are positional by command 
code. 

Length field of first, variable-length parame- 
ter (LVD. This field is either 1 byte or 2 
bytes in length based on the setting of 
FMH6LNSZ (0 = one byte, 1 = two bytes). If the 
length field (LVx) is equal to zero, then the 
variable parameter is omitted. The next vari- 
able-length parameter length (LV2) occurs in 
byte q+1 . 

Variable-length parameter (VP). The LV and VP 
fields are replicated to represent x number of 
variable-length parameters according to command 
code. 



1-7 



5-n 



FMH6M0D 

FMH6LNSZ 

B'O' 

B'l' 



FMH6FXCT 



n+l-m 



m+l-p 



Fxt Parms 



V length 



p+l-q 



V parm 
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FUNCTION MANAGEMENT HEADER TYPE 7 (FMH-7) 



FMH-7 is sent from one session partner to the other to define the cause of an 
error and to provi de corrective information. The corrective information is 
called an ERP message, which can be any information understood by the session 
partners. An ERP message may contain any of the FM level LU__T6 sense codes. 

Meani ng 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Reserved 

FMH-7 identifier 

SNA sense code, which would appear on error 
response. 

Sequence number of RU chain in which error was 

detected. 



Bvte 



Bit 


Content 
Length 


1 





FMHC 
B f 0» 

B'l' 




1-7 


B'0000111' 


2-5 




ERPSENSE 



6-7 



ERPSEQ 



FUNCTION MANAGEMENT HEADER TYPE 10 (FMH-10) 



FMH-10 requests that the receiver prepare for a sync point. The receiving 
session partner, on the next flow, either requests a sync point or aborts the 
unit of work 

The FMH-10 must be the first FM header of an RU chain, and the chain must have 
the CD bit set on; it may be sent requesting either a definite response or an 
exception response. For those RU chains that have requested a definite 

>g 




w i K.I it! (\u wild ill k^uiucj I in uy lu« rim jl u uiuy . rgr « i n itsr i eafJunsB uaityui y> 

the receiver may then choose to comply or not comply with the sync point; that 
is, by sending, on the next flow, a request with the DR2I = B f l* (requesting 
the sync point), or an FMH-7 (abort). 



Bvte 



Bit 


Content 
Length 


1 





FMHC 
B'O' 
B'l» 




1-7 


B'QOOIOIO* 


2-3 




SPCCMD 
X'0202' 



4-5 



SPCMOD 

X'OOOO* 
X'0001' 
X'0002' 



Meaning 

Length of header including length byte 

FMH concatenation. 
No FMH follows 
Another FMH follows 

FMH-10 identifier 

Command: 

Prepare 

(other values reserved) 

Modifier. For a prepare command (FMH-10), the 
modifier indicates DFC settings to be returned 
on the first RU chain sent by the FMH-10 receiv- 
er. 

*CD,*EB. The sender of FMH-10 does not care 
what DFC settings are returned on the reply. 
EB. The sender of FMH-10 requires an EB on the 
reply. 

CD,--EB. The sender of FMH-10 requires a CD on 
the reply. 
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PART 2 CHAPTER 5. COMPRESSION AND COMPACTION 



Data compression and data compaction are data-handling techniques used by 
LU-LU session types 1 and 4 to shorten network transmissions. Data is 
compressed or compacted by the half-session before the data is sent to the 
session partner. The session partner then decompresses or decompacts the 
data before passing it to the end user. 

Data can be compressed by eliminating gaps, empty fields, redundancies, or 
unnecessary data. The technique used within LU-LU session types 1 and 4 i s to 
select one character, called the prime compression character, and replace 
repetitive sequences of that character with a string control byte (SCB). One 
SCB can replace up to 63 characters (bytes), but the characters must be a 
string of the same prime character. An SCB can also define strings of like 
characters that are not the prime compression character, but to define the 
string so that the receiver knows which character was compressed, the SCB 
must be followed by a byte containing the nonprime character. 




SCB fields are defined in Figure 5-8. Within each SCB, the first 2 bits 
define the function to be performed, and the last 6 bits provide a count. 

When a half-session sends compressed or compacted data, it sets on the 
compression indicator (CMI) or compaction indicator (CPI) in the FMH-1 begin- 
ning the data. Accordingly, a BEGIN, BEGIN/END, or CONTINUE FMH-1 may have 
the CMI, CPI, or both set on. If either flag is set on by the sending 
half-session, the half-session must build and insert one or more SCBs into 
the data stream. An SCB must either begin the chain or follow any FM headers 
that may be present in the chain. 

There is no SCB sensitivity to control information in the data stream. If 
control information such as SCS controls exists, the SCB treats it as another 
byte of data. 

The settings of CMI and CPI in the FMH-1 control the use of the SCB code 
points: 

CMI CPI Definition 

No SCB is present. 

1 Only code points 00 and 01 are valid. 

1 Only code points 00, 10, and 11 are valid. 

1 1 All code points are valid. 

You should use a count greater than 1 and 2 for SCB code points 10 and 11, 
respectively. Lesser counts result in an expansion of the data. 

Before using compaction, you should compare the computation time used to 
compact and decompact the data against the transmission time saved. 
Compaction may improve overall throughput when the network's communication 
paths are overloaded (too much network traffic or possibly slow-speed commu- 
nication paths). Compaction may not be efficient when the data has few 
occurrences of master characters and when the network has high-speed or 
broadband communications paths. 
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SCB code point Count 
00 000000 
00 nnnnnn 



10 
10 



11 
11 



000000 
nnnnnn 



000000 
nnnnnn 



01 



000000 



Descripti on 

Invalid control code 

No duplicate characters. 
Count = number of bytes 
between this SCB and the 
next one. nnnnnn is a value 
from 1 to 63. 

Invalid control code 

Repeated prime character. 
Count = number of prime 
characters represented by 
this SCB. The next byte is 
the next SCB. nnnnnn is a 
value from 1 to 63. 

A space is the default unless 
a PRIME COMPRESSION CHARACTER 
FMH-2 or FMH-3 was received 
before this SCB was received. 

Invalid control code 

Repeated next character. 

Count = number of times 

the next character is repeated. 

The next SCB follows the 

character to be repeated. 

nnnnnn is a value from 1 

to 63. 

Invalid control code 



Ul nnnnnn uoinpaction coae. 

Count = number of compacted 
bytes between this SCB and 
the next one. nnnnnn is a 
value from 1 to 63. 

Figure 5-8. String control bytes (SCBs). These define how data is 
compressed and compacted. 

CHANGING THE PRIME COMPRESSION CHARACTER 

The prime compression character is assumed to be the space character (X f 40 T ). 
When another character is desired, it can be defined for one destination 
using the PRIME COMPRESSION CHARACTER FMH-2; or, if desired for all destina- 
tions in the session, defined using the PRIME COMPRESSION CHARACTER FMH-3. 
These FM headers are discussed in Part 2 Chapter 4. 

SELECTING A COMPACTION TABLE 

Data compaction, as used by LU-LU session types 1 and 4, limits the LU to 
representing a character using one of two lengths — 4 bits or 8 bits. 
Accordingly, 1 byte in the data stream can represent one or two characters of 

data. 

When a character is represented by 4 bits, it is called a master character. 
There can be up to 16 master characters; however, the more master characters, 
the fewer the representable characters. This relationship is shown in Figure 
5-9. As the number of master characters rises, the maximum number of charac- 
ters decreases. 
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Master Characters 


Nonmaster Characters 


Total Characters 





Not supported 




1 


Note 1 




2 


Note 1 




3 


244 


247 


4 


236 


240 


5 


226 


231 


6 


214 


220 


7 


200 


207 


S 


184 


192 


9 


166 


175 


10 (Note 2) 


146 


156 


11 


124 


135 


12 


100 


112 


13 


74 


87 


14 


46 


60 


15 


16 


31 


16 





16 


Note 1: Specifying 1 or 2 master characters is invalid. 


Note 2: Using less than 10 master characters is an 


implementation option. 



Figure 5-9. Master character to nonmaster character ratios. The total chai — 
acters column represents the number of unique characters that may be sent 
under SCB code point 01 for a given number of master characters. 

Since there can be a variety of SCBs in an RU , those that do not use SCB code 
point 01 are independent of the charactgr restrictions of the compaction set. 

End users should examine the characteristics of their data streams and deter- 
mine the frequency of characters. Those characters used most frequently 
should be the master characters. Because master characters must occur in 
pairs in the data stream for them to be compacted, you should search for chai — 
acters that consistently interrupt master character pairing. The compaction 
ef f i ci ency may be improved if you use the interrupting character(s) as a 
master character(s) . 

For compaction efficiency, you should select as many master characters as 
possible and still represent all the characters in your data stream. By 
using Figure 5-9, you can determine the correct number. 

Once master characters are selected, a table can be constructed and transmit- 
ted to the session partner as discussed under "Compaction Table" in both the 
"Function Management Header Type 2" and "Function Management Header Type 3" 
sections in Part 2 Chapter 4. 



SCB CONCATENATION AND CHAINING RULES 

An SCB must either begin the RU chain or follow any FM headers that may be 
present in the chain. 



SCB DATA RULES 

If 16 master characters are used, the uncompacted data stream must be an even 
number of bytes. If it is not even, a second SCB must be created to describe 
the odd byte. 
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ACRONYMS AND ABBREVIATIONS 



APPENDIX A; ACRONYMS AND ABBREVIATIONS 



+ DR2 
+RSP 
-RSP 



ACTLINK 

ACTLU 

ACTPU 

ADS 

AID 

ASCII 

ATTN 

BB 

BBI 

BC 

BCI 

BDS 

BEDS 

BETB 

BIU 

BLK 

BSC 

CD 

CINIT 

CDI 

CDS 

CM I 

CONT 

CPI 

CR 

CRT 

CRV 

DACTLU 
DACTPU 
DAF 

DBA 

DEL 

DFC 

DLC 

DMU 

DP 

DPN 

DQN 

DR1 

DR1I 

DR2 

DR2I 

DSP 

DSSEL 

DUP 

EAU 

EB 

EBI 

EBCDIC 

EC 

ECI 

EDI 

EDS 



Positive 
Posi ti ve 
Negati ve 
Not 

Equals 
Equi valent 



response 
response 
response 



to 



to RU chain sent with DR2I = B'l 1 



Activate link 
Activate logical unit 
Activate physical unit 
Abort destination selection 
Attention identification 
American national standard code 
Attenti on 



for information interchange 



Begin bracket 

Begin bracket indicator 

Begin chain 

Begin chain indicator 

Begin destination selection 

Begin/end destination selection 

Between brackets 

Basic information unit 

Block 

Binary synchronous communication 

Change direction 

Control initiate 

Change direction indicator 

Continue destination selection 

Compression indicator 

Contention, continue 

Compaction indicator 

Carriage return 

Create 

Cryptographic verification 

Deactivate logical unit 

Deactivate physical unit 

Destination address field 

Deblocking algorithm 

Delete 

Data flow control 

Data link control 

Destination-unique message unit 

Data processing 

Destination program name 

Destination queue name 

Definite response one 

Definite response one indicator 

Definite response two 

Definite response two indicator 

Data stream profile 

Destination selection 

Duplicate 

Erase all unprotected 

End bracket 

End bracket indicator 

Extended binary-coded decimal interchange code 

End chain 

End chain indicator 

Enciphered data indicator 

End of destination selection 
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EM End of message 

EO Eight ones 

EOC End of card 

ERCL Exchange record length 

ERI Exception reponse indicator 

ERP Error recovery procedure 

ERPR Error recovery procedure, receive 

ERPS Error recovery procedure, send 

EUA Erase unprotected to address 

EW Erase/write 

El*JA Erase/write alternate 

EXR Exception request 

FAP Format and protocol 

FF Flip flop 

FI Format indicator 

FF Form feed 

FFR Field formatted record 

FFR-FNI Fixed fields without field separators 

FFR-FS Fixed fields with field separators 

FFR-FS2 Fixed fields with or without field separators 

FM Function management, field mark 

FMD Function management data 

FMDS Function management data services 

FMH Function management header 

FMH-n Function management header type n 

FMP Function management profile 

FSM Finite-state machine 

GCID Global coded graphic character set identifier 

GE Graphic escape 

HDX Half-duplex 

HDX-CONT HDX contention 

HDX-FF HDX flip-flop 

HSCB Half-session control block 

HSID Half-session identification 

IC Insert cursor 

ID Identification 

INB In bracket (state) 

INPID Inbound partition identifier 

INOP Inbound operation 

ITA International telephone alphabet 

IU Interchange unit 

IUE Interchange unit end 

IUT Interchange unit type 

LCID Local coded graphic character set identifier 

LLID Structured field length (LL) and identifier (ID) 

LRC Longitudinal redundancy character 

LRH Logical record header 

LU Logical unit 

LU_Tn LU-LU session type n 

LUSTAT Logical unit status 

MF Modify field 

MGR Manager 

MPL Maximum presentation line 

MPP Maximum presentation position 

MS Media services 

MSG Message 

MSR Magnetic slot reader 

MU Message unit 

NAU Network addressable unit 

NC Network control 

NS Network services 

NU Nonshared and unnamed 

NUL Null 

OAF Origin address field 
242 SNA — Sessions between Logical Units 



p— >s 

PC 

PIU 

PLU 

PRI 

PRN 

PS 

PSA 

PSE 

PT 

PU 

QC 

QEC 

QRI 

RA 

RAP 

RB 

RCD 

RCV 

RDPN 

RDS 

RELQ 

RH 

RM 

RMA 

RPL 

RPRN 

RQD 

RQD2 

RQE 

RQE2 

RQR 

RSHUTD 

RSP 

RT 

RTI 

RTR 

RU 

RWS 

S— >P 

SA 

SBA 

SC 

SCB 

SCS 

SDLC 

SDS 

SDT 

SEC 

SF 

SFE 

SHUTC 

SHUTD 

SIG 

SLU 

SN 

SNA 

SP 

SPS 

SRI 

SS 

SSCP 

STSN 

SU 

SUB 

SUW 

SVC 

SYNC 



Primary to secondary 

Path control 

Path information unit 

Primary logical unit 

Primary 

Primary resource name 

Presentation services, programmed symbols 

Presentation space altered 

Presentation space error 

Program tab 

Physical unit 

Quiesce complete 
Quiesce at end of chain 
Queue response indicator 



Repeat to a 
Reset attac 
Read buffer 
Request cha 
Recei ve 
Return dest 
Resume dest 
Release qui 
Request/res 
Read modifi 
Read modifi 
Replace 
Return prim 
Request def 
Request def 
Request exc 
Request exc 
Request r&c 
Request shu 
Response 
Response ty 
Response ty 
Ready to re 
Request uni 
Read/wri te 



ddress 

hed program 

nge direction 

i nation program name 
ination selection 

esce 

ponse header 

ed 

ed all 

ary resource name 

inite response 

inite response with DR2I on 

eption response 

eption response with DR2I on 

overy 

tdown 

pe 

pe indicator 

cei ve 

t 
storage 



Secondary to prima 
Set attribute 
Set buffer address 
Session control 
String control byt 
SNA character stri 
Synchronous data I 
Suspend destinatio 
Start data traffic 
Secondary 
Start field 
Start field extend 
Shutdown complete 
Shutdown 
Si gnal 

Secondary logical 
Shared and named 
Systems network ar 
Start print 
Session presentati 
Stack reference in 
Start sentinel 
System services co 
Set and test seque 
Shared and unnamed 
Substi tute 
Synchronized unit 
Servi ce(s) 
Synchroni zati on 



ry 



e 

ng 

ink control 

n selection 



ed 

uni t 

chi tecture 

on services 
di cator 

ntrol point 
nee numbers 

of work 
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TC Transmission control 

TH Transmission header 

TM Top margin 

TS Transmission dubsystem 

TSP TS profile 

UPD Update 

UPM Undefined protocol machine 

VFC Vertical forms control 

WCC Write control character 

WP Word processing 

WSF Write structured field 

3270 IBM 3270 information display system 

3277 IBM 3277 display station 
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APPENDIX B. RU SIZES VALID IN BIND SESSION 





Mantissa (a) 


Exponent 
(b) 


8 


9 


A 
(10) 


B 
(11) 


C 
(12) 


D 
(13) 


E 
(14) 


F 
(15) 





8 


9 


10 


11 


12 


13 


14 


15 


1 


16 


18 


20 


22 


24 


26 


28 


30 


2 


32 


36 


40 


44 


48 


52 


56 


60 


3 


64 


72 


80 


88 


96 


104 


112 


120 


4 


128 


144 


160 


176 


192 


208 


224 


240 


5 


256 


288 


320 


352 


384 


416 


448 


480 


6 


512 


576 


640 


704 


768 


832 


896 


960 


7 


1024 


1152 


1280 


1408 


1536 


1664 


1792 


1920 


8 


2048 


2304 


2560 


2816 


3072 


3328 


3584 


3840 


9 


4096 


4608 


5120 


5632 


6144 


6656 


7168 


7680 


A (10) 


8192 


9216 


10240 


11264 


12288 


13312 


14336 


15360 


B (11) 


16384 


18432 


20480 


22528 


24576 


26624 


28672 


30720 


C (12) 


32768 


36864 


40960 


45056 


49152 


53248 


57344 


61440 


D (13) 


65536 


73728 


81920 


90112 


98304 


106496 


114688 


122880 


E (14) 


131072 


147456 


163840 


180224 


196608 


212992 


229376 


245760 


F (15) 


262144 


294912 


327680 


360448 


393216 


425984 


45S752 


491520 



Note : A value of X*ab' in byte 10 or byte 11 of BIND represents a«2**b. For example, 
X'CS' represents (in decimal) 12 times 2 to the 5th power, or 384. 
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INDEX 



abbreviations 241 
acronyms 241 
active destination 

LU_T1 and LU_T4 188 
add FMH-2 212 
add replicate FMH-2 213 
adjust-text mode, SCS 152 
architecture components 1 
attach FMH-5 231 
auto-letter mode, SCS 152 



B 

backspace CBS) SCS control 132 
begin-end FMH-1 

format 210 

rules 191 

using 187 
begin FMH-1 

format 210 

rules 191 

using 187 
BEL (bell) SCS control 132 
bell (BEL) SCS control 132 
BIND request 

LU_T1 format 27 

LU_T2 format 53 

LU_T3 format 66 

LU_T4 format 95 

LU_T6 format 120 

purpose of 3 

RU size matrix 245 
BS (backspace) SCS control 132 
buffer size in LU T3 61 



carriage return (CR) SCS control 132 

chaining rules, FMH 194 

checkpoint protocol 8 

checkpoints, LU_T1 20 

CMI (compression indicator) 208, 237 

compaction 

description of 237 
compaction indicator (CPI) 208, 237 
compaction table 

selecting 238 
compaction table FMH-2 214 
compaction table FMH-3 227 
components of architecture 1 
compressi on 

description of 237 
compression indicator (CMI) 208, 237 
concatenation rules 

FMH-1 194 

FMH-2 195 

FMH-3 195 

SCB 239 
configuration services 7 
continue FMH-1 

format 210 

rules 191 

using 187 



copy function in LU_T2 40 
CPI (compaction indicator) 208, 237 
CR (carriage return) SCS control 132 
create data set FMH-2 215 
cryptography options 

LU_T1 BIND 36 

LU_T2 BIND 58 

LU_T3 BIND 70 

LU_T4 negotiable BIND 110 

LU_T4 nonnegotiable BIND 103 

LU_T6 BIND 125 
CU (customer use) SCS control 132 
customer use (CU,CU1 , CU3) SCS control 132 



D 



data compaction 237 
data compression 237 
data descriptor FMH-5 233 
data direction resolution 

LU_T4 76 
data flow control (DFC) 



for 
for 
for 
for 
for 



LU 

LU" 

LU" 

LU" 

LU" 



Tl 
T2 
T3 
T4 
T6 



14 
41 
62 
75 
114 



for 


LU 


Tl 


for 


LU" 


"T2 


for 


LU 


"T3 


for 


LU" 


~T4 


for 


LU" 


"T6 



data management 

using FMH-2 189 

using FMH-3 190 
data rules 195 
data stream 

defaults 186 
data stream profile field of FMH-1 208 
data stream profiles 

LU_T1 17 

LU_T4 84 

LU_T6 116 
data streams 

See also SNA 3270 data stream, SCS 
controls 

14, 129 
157 
157 

74, 129 
114 
DC (device control) SCS control 133 
default data stream 186 
default destination 188 
describing data 

using FMH-4 i9/ 
destinati on 

active 188 

default for LU_T1 and LU_T4 

management, in LU_T1 and LU_ 

selecting 186 
destination name field of FMH-1 
destination selection 

FMH-1 summary 192 

rules for FMH-1 191 

using FMH-1 187 
destination selection field of FMH-1 208 
destination stacks 188 
device control (DCn) SCS control 133 
device sharing, LU_T2 40 
device sharing, LU_T3 62 



188 
T4 188 

209 
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DFC 

See data flow control 
display printout, LU_T2 40 
display sharing, LU_T2 41 
distributed transaction processing 113 
domains of network 7 
DSNAME field of FMH-1 209 
DSP select field of FMH-1 208 
DSSEL field of FMH-1 208 



EBS (expanded backspace) SCS control 133 
enable presentation (ENP) SCS control 133 
end-abort FMH-1 

format 210 

rules 191 

usi ng 187 
end-user data parameters 

LU_T1 BIND 37 

LU_T2 BIND 58 

LU_T3 BIND 71 

LU_T4 negotiable BIND 110 

LU_T4 nonnegotiable BIND 103 

LU_T6 BIND 126 
end FMH-1 

format 210 

rules 191 

using 187 
end user 

boundary to LU 7 

def i ni ti on of 2 
ENP (enable presentation) SCS control 133 
erase data set FMH-2 218 
erase FMH-2 217 
ERCL (exchange record length) field of 

FMH-1 20 9 
errors 

backspace in SCS 154 

LU_T1 22 

SCS controls 153 

SCS graphics 153 
ESP (expanded space) SCS control 150 
examples 

LU_T2 sequences 50 

LU_T4 sequences 93 

LU_T4 stacks 79 

of stacks 193 
exchange record length field of FMH-1 209 
execute program offline FMH-2 218 
expanded backspace (EBS) SCS control 133 
expanded space (ESP) SCS control 150 
extension FMH-2s 189 



FF (form feed) SCS control 133 
FI (format indicator) of RH 186 
finite state machine (FSM) 6 
FMD (function management data) 6 
FM data rules 

FMH-1, FMH-2, FMH-3 191 
FMH-1 

fields defined 207 

purpose of 186 

rules 191 

sense codes 196 

SPS.RCV and SPS.SEND processing 10 

usi ng 187 
FMH-10 

fields defined 236 



purpose of 187 

SPS.RCV and SPS.SEND processing 10 

usi ng 204 
FMH-2 

data set organizations 189 

extension FMH-2s 189 

fields defined 211 

purpose of 186 

root FMH-2s 189 

sense codes 196 

SPS.RCV and SPS.SEND processing 10 

using 189 
FMH-3 

fields defined 227 

purpose of 186 

sense codes 196 

SPS.RCV and SPS.SEND processing 10 

using 190 
FMH-4 

fields defined 230 

purpose of 186 

SPS.RCV and SPS.SEND processing 10 

using 197 
FMH-5 

purpose of 187 

SPS.RCV and SPS.SEND processing 10 
FMH-6 

fields defined 235 

purpose of 187 

SPS.RCV and SPS.SEND processing 10 
FMH-7 

fields defined 236 

purpose of 187 

SPS.RCV and SPS.SEND processing 10 
FM headers 

FMH-1 fields defined 207 

FMH-10 fields defined 236 

FMH-2 fields defined 211 

FMH-3 fields defined 227 

FMH-4 fields defined 230 

FMH-6 fields defined 235 

FMH-7 fields defined 236 

LU_T1 processing 16, 187 

LU_T1 use 13 

LU_T4 processing 78, 187 

LU_T6 processing 115, 197 

LU_T6 use 114 

purpose of 185 

rules for FMH-1, FMH-2, FMH-3 191 

types allowed by sessions 187 

types of 186 

usi ng 185 
FM headers (see also LU_T1 BIND and LU_T4 

BIND) 206 
FMHs (see FM headers) 185 
FM prof i le 

LU_T1 13 

LU_T1 BIND 27 

LU_T2 BIND 53 

LU_T3 BIND 66 

LU_T4 74 

LU_T4 negotiable BIND 105 

LU_T4 nonnegotiable BIND 95 

LU_T6 113 

LU_T6 BIND 120 

summary of 5 
FM usage 

See FM prof i le 
FM usage parameters 

LU_T1 BIND 27 

LU_T2 BIND 53 

LU_T3 BIND 66 

LU_T4 negotiable BIND 105 
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95 



133 
6 



LU_T4 nonnegotiable BIND 
LU_T6 BIND 120 
format indicator of RH .186 
formatting of media 151 
form feed (FF) SCS control 
FSM (finite state machine) 
function management header 
type 1 (FMH-1) 207 
type 10 CFMH-10) 236 
type 2 (FMH-2) 211 
type 3 CFMH-3) 227 
type 4 (FMH-4) 230 
type 6 (FMH-6) 235 
type 7 CFMH-7) 236 
function management headers 
headers) 185 



GE (graphic escape) SCS control 
graphic escape (GE) SCS control 



H 

half-sessi on 

See also LU_T1, LU..T2, LU_T3, LUJT4, and 

LU_T6 
activation and deactivation 6 
definition of 3 
managing LU_T1 and LU_T4 

destinations 187 



protocols 




LU Tl BIND 


27 


LU T2 BIND 


53 


LU T3 BIND 


66 



LUJT4 negotiable BIND 105 

LU_T4 nonnegotiable BIND 95 

LU_T6 BIND 120 
types 5 
usage parameters 

LU_T1 BIND 32 

LU_T2 BIND 57 

LU_T3 BIND 69 

LU_T4 negotiable BIND 107 

LU_T4 nonnegotiable BIND 99 

LU_T6 BIND 125 
half-session, control block (HSCB) 6 
half-sessi on activation parameters 

(HSAP) 6 
hierarchy rules for FMH-1, FMH-2, FMH-3 
horizontal tab (HT) SCS control 134 
HSCB (half-session control block) 6 
HT (horizontal tab) SCS control 134 



191 



IFS (interchange file separator) SCS 

control 135 
IGS (interchange group separator) SCS 

control 135 
indent tab (IT) SCS control 134 
index return (IR) SCS control 134 
inhibit presentation (INP) SCS control 135 
INP (inhibit presentation) SCS control 135 
interchange separator (IUS, IRS, IGS, IFS) SCS 

controls 135 
IR (index return) SCS control 134 
IRS (interchange record separator) SCS 

control 135 
IT (indent tab) SCS control 134 



IUS (interchange unit separator) SCS 

control 135 



LF (line feed) SCS control 135 
line feed (LF) SCS control 135 
load programmed symbols structured 

field 19 
logical unit 

See also LU_T1, LU__T2, LUJT3, LUJT4, and 
LU T6 





def ini ti on of 


1, 


2 


FM 


structure 2 








LT_CCR, function 


of 


10 




LT_CCS, function 


of 


11 




LT_DSR, function 


of 


10 




LT DSS, function 


of 


11 




LT_FRR, function 


of 


10 


133 


LT FRS, function 


of 


11 


19, 133 


LT_MSR, function 


of 


10 




LT_MSS, function 


of 


11 



16 

16, 21 
53 



LU.SVCJ1GR (LU services manager) 6 
LU_T1 

BIND request format 27 

data flow control 14 

data stream controls 129 

data stream profiles 17 

data streams 14 

default destination 188 

errors 22 

FM headers 13 

half-session characteristics 13 

LUSTAT (LU Status) request 21 

overview 13 

presentation services 

profiles 13 

protocols 14 

sense codes 24 

SIG (Signal) request 
LU_T2 

BIND request format 

CANCEL request 45 

data flow control 41 

data stream 157 

device sharing 40 

display printout 40 

display sharing 41 

errors 42, 46 

half-session characteristics 40 

magnetic stripe 39 

overview 39 

protocols 41 

screen size 39 

sense codes 44 

sequence examples 50 

SNA 3270 data stream use 39 

structured fields 159 
LUJT3 

BIND request format 66 

buffer size 61 

data flow control 62 

data stream 157 

device sharing 62 

errors 63, 65 

half-session characteristics 

overview 61 

protocols 62 

sense codes 63 

SNA 3270 data stream use 61 

structured fields 159 
LUT4 



61 
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LU 



BIND request format 

negotiable 105 

nonnegotiable 95 
BIND request overview 73 
change-direction management 75, 78 
data flow control 75 
data processing DSPs 86 
data stream controls 129 
data stream profiles 84 
data streams 74, 84 
default destination 188 
errors 89 
FN headers 78 

half-session characteristics 74 
LUSTAT request 77, 83, 91 
medi a 85 
overview 73 

presentation services 78 
prof i les 74 
protocols 75 
sense codes 89 
sequence examples 93 
SIG (Signal) request 76, 83 
stacks 7 9 

transmission control (TO 75 
unattended operation 83 
word processing DSPs 87 
T6 

"BIND 
data 
data 
data 



request format 120 
flow control 114 
stream profiles 116 
streams 114 
FM headers 114 

half-session characteristics 113 
overvi ew 113 
presentation services 115 
prof i les 113 
protocols 114 
SIG CSignal) request 115 
LU overvi ew 3 

LU services manager (LU.SVC_MGR) 3, 6 
LUSTAT request 
LU_T1 21 
LU_T4 77, 83, 91 
LU structure 6 
LU types 5 



M 



magnetic stripe, LU_T2 39 

maintenance and management services 

master character 238 

media formatting 151 

mediums, selecting 186 

medium selection using FMH-1 207 



SCS control 
SCS control 



null (NUL) SCS control 135 



password FMH-2 220 
path control network 

def i ni ti on of 1, 2 
path information unit (PIU) 185 
PDIR (peripheral data information record) 

FMH-2 221 
peripheral data information record (PDIR) 

FMH-2 221 
physical unit (PU) 2 
PIU (path information unit) 185 
POC (program operator communication) SCS 

control 137 
ports 2 

PP (presentation position) 
presentation position (PP) 
presentation services 7 

LU_T1 16 

LU_T4 78 

LU_T6 115 
presentation surface 131 
prime compression character 
prime compression character 
prime compression character 
profiles 3 

program operator communication (POC) SCS 
control 137 

prof i le 

LU_T1 

LU_T1 

LU_T2 

LU_T3 

LU_T4 

LU_T4 

LU_T4 

LU_T6 

LU_T6 BIND 

relati on to 

summary of 
PS usage 

See PS prof i le 

usage parameters 

LU_T1 BIND 31 
BIND 57 
BIND 69 

negotiable BIND 107 
nonnegotiable BIND 99 
BIND 125 



136 
136 



PS 



238 

FMH-2 
FMH-3 



13 

BIND 

BIND 

BIND 

74 
negotiable BIND 107 
nonnegotiable BIND 99 
113 

124 

LU type 5 

5 



222 
228 



31 
57 
69 



PS 



LU_T2 

LU_T3 
LU_T4 
LU_T4 
LU T6 



PU (physical unit) 2 



Q 



N 



NAU (network addressable unit) 

negotiable BIND for LU_T4 105 

negotiable BIND for LU_T6 120 

network addressable unit (NAU) 

network operator services 7 

network services 7 

new line (NL) SCS control 135 

NL (new line) SCS control 135 

nonnegotiable BIND for LU_T4 

nonnegotiable BIND for LU_T6 

note FMH-2 219 

note reply FMH-2 219 

NUL (null) SCS control 135 



95 
120 



query for compaction table FMH-3 
query for data set FMH-2 222 
query reply structured field 19 



228 



RAP (reset attached process) FMH-5 234 

read partition structured field 19 

receive stack 188 

record-ID FMH-2 223 

recovery data structured field 19 

repeat (RPT) SCS control 137 

replace FMH-2 224 

replace replicate FMH-2 225 

request-response header (see RH) 186 
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request-response unit (see RU) 186 
request recovery data structured field 19 
required form feed (RFF) SCS control 137 
required new line (RNL) SCS control 138 
required space (RSP) SCS control 151 
reset attached process FMH-5 234 
restart structured field 19 
resume FMH-1 

format 210 

rules 191 

using 187 
RFF (required form feed) SCS control 137 
RH 

format indicator 186 

use in transmissions 185 
RNL (required new line) SCS control 138 
root FMH-2s 189 
RPT (repeat) SCS control 137 
RSP (required space) SCS control 151 
RU 

content of 185 

use in transmissions 185 
rules 

chaining of FMHs 194 

data 195 

FMH-1 concatenation 194 

FMH-2 concatenation 195 

FMH-3 concatenation 195 

FM headers and data 191 

SCB 239 
RU size matrix 245 



SA (set attribute) SCS control 139 
SBS (subscript) SCS control 147 
SCB (string control byte) 

using 237 
SCI (set chain image) SCS control 141 
scratch all data sets FMH-2 225 
scratch data set FMH-2 226 
screen size in LU_T2 39 

SCS (SNA character string) controls 129 
SCS code points 156 
SCS control and graphic errors 153 
SCS data structured field 19 
SCS defaults 154 
secure string ID reade-r (SSR) SCS 

control 138 
select left platen (SLP) SCS control 138 
select magnetic encoder (SME) SCS 

control 139 
select right platen (SRP) SCS control 139 
send stack 188 
sense codes 

FMH = 1, FMH-2, FMH-3 196 

Lu_il 24 

LU_T2 44 

LU_T3 63 

LU_T4 8 9 

LU_T6 118 
series-ID FMH-3 229 
sessi on 

activation and deactivation 6 

control blocks 6 

LU-LU 3 

SSCP-LU 3 

types of LU-LU 3 
session network services 7 
session presentation services (SPS) 5, 8 
session services 7 
set attribute (SA) SCS control 19, 139 



set attribute SCS control 18 

set chain image (SCI) SCS control 141 

set checkpoint interval structured 

field 19 
set graphic error action (SGEA) SCS 

control 141 
set horizontal format (SHF) SCS control 142 
set line density (SLD) SCS control 143 
set print density (SPD) SCS control 144 
set translation table (STT) SCS control 144 
set vertical format (SVF) SCS control 144 
SGEA (set graphic error action) SCS 

control 141 
SHF (set horizontal format) SCS control 142 
shift in (SI) SCS control 146 
shift out (SO) SCS control 146 
SHY (syllable syphen) SCS control 151 
SI (shift in) SCS control 146 
SIG (Signal) request 

LU_T1 16, 21 

LU_T4 76, 83 

LU_T6 115 
SLD (set line density) SCS control 143 
SLP (select left platen) SCS control 138 
SME (select magnetic encoder) SCS 

control 139 
SNA character string (SCS) controls 129 
SNA 3270 data stream 

description 157 

LU_T2 use 39 

LU_T3 use 61 
SO (shift out) SCS control 146 
SOF (start of format) SCS control 146 
SPD (set print density) SCS control 144 
SPS 

See also session presentation services 

f unct i on of 10 

structure 8 
SPS.RCV, function of 10 
SPS. SEND, function of 11 
SPS (session presentation services) 8 
SPS (superscript) SCS control 147 
SRI (stack reference indicator) 188 

of FMH-1 208 

of FMH-2 212 
SRP (select right platen) SCS control 139 
SSR (secure string ID reader) SCS 

control 138 
stack examples 193 
stack reference indicator (SRI) 188 

of FMH-1 208 

of FMH-2 212 
stacks 

LU_T4 stacks 79 

using 188 
start of format (SOF) SCS control 146 
status FMH-3 229 
string control byte (SCB) 

rules 239 

using 237 
structured fields 

LU_T1 17 

3270 data stream 159 
structure of LU 6 

STT (set translation table) SCS control 144 
SUB (substitute) SCS control 147 
subscript (SBS) SCS control 147 
substitute (SUB) SCS control 147 
superscript (SPS) SCS control 147 
suspend FMH-1 

format 210 

rules 191 

using 187 



Index 251 



SVF (set vertical format) SCS control 144 

SW (switch) SCS control 147 

switch (SW) SCS control 147 

syllable hyphen (SHY) SCS control 151 
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